date() 是 PHP 最常用的日期時間格式化函數,將 Unix 時間戳轉為可讀字串。本文完整列出格式字元對照表、時間戳操作、常見格式範例與時區處理。
<?php
date(string $format, ?int $timestamp = null): string
// 參數
// $format: 格式字串(必填)
// $timestamp: Unix 時間戳(可選,預設 time() 當前時間)
// 回傳:格式化後的日期時間字串
?>
| 字元 | 說明 | 範例輸出 |
|---|---|---|
| 日 | ||
d | 月份中的第幾天,2 位數補零 | 01 到 31 |
D | 星期幾,3 字母縮寫 | Mon 到 Sun |
j | 月份中的第幾天,不補零 | 1 到 31 |
l (小寫 L) | 星期幾,完整名稱 | Sunday 到 Saturday |
N | ISO-8601 星期幾 | 1 (週一) 到 7 (週日) |
S | 序數後綴 | st, nd, rd, th |
w | 星期幾(數字) | 0 (週日) 到 6 (週六) |
z | 年份中的第幾天 | 0 到 365 |
| 週 | ||
W | ISO-8601 年份週數 | 例:42 |
| 月 | ||
F | 月份完整名稱 | January 到 December |
m | 月份數字,2 位數補零 | 01 到 12 |
M | 月份縮寫,3 字母 | Jan 到 Dec |
n | 月份數字,不補零 | 1 到 12 |
t | 該月總天數 | 28 到 31 |
| 年 | ||
L | 是否閏年 | 1 或 0 |
o | ISO-8601 年份編號 | 例:2024 |
Y | 4 位數年份 | 例:2024 |
y | 2 位數年份 | 例:24 |
| 時間 | ||
a | am/pm 小寫 | am 或 pm |
A | AM/PM 大寫 | AM 或 PM |
B | Swatch Internet Time | 000 到 999 |
g | 12 小時制,不補零 | 1 到 12 |
G | 24 小時制,不補零 | 0 到 23 |
h | 12 小時制,2 位數補零 | 01 到 12 |
H | 24 小時制,2 位數補零 | 00 到 23 |
i | 分鐘,2 位數補零 | 00 到 59 |
s | 秒數,2 位數補零 | 00 到 59 |
u | 微秒(PHP 5.2.2+) | 例:654321 |
| 時區 | ||
e | 時區識別名 | UTC, Asia/Taipei |
I | 是否夏令時間 | 1 或 0 |
O | 與格林威治時差(小時) | +0800 |
P | 與格林威治時差(含冒號) | +08:00 |
T | 時區縮寫 | CST, EST, PDT |
Z | 時區偏移秒數 | -43200 到 50400 |
| 完整格式 | ||
c | ISO 8601 格式 | 2024-01-15T14:30:00+08:00 |
r | RFC 2822 格式 | Mon, 15 Jan 2024 14:30:00 +0800 |
U | Unix 時間戳 | 1705312200 |
<?php
$now = time(); // 當前時間戳
echo date('Y/m/d', $now); // 2024/01/15
echo date('Y-m-d', $now); // 2024-01-15
echo date('Y.m.d', $now); // 2024.01.15
echo date('Y年m月d日', $now); // 2024年01月15日
echo date('Y/m/d H:i:s', $now); // 2024/01/15 14:30:00
echo date('Y-m-d H:i:s', $now); // 2024-01-15 14:30:00
echo date('l, F jS, Y', $now); // Monday, January 15th, 2024
echo date('D, M j, Y g:i A', $now); // Mon, Jan 15, 2024 2:30 PM
echo date('c', $now); // 2024-01-15T14:30:00+08:00 (ISO 8601)
echo date('r', $now); // Mon, 15 Jan 2024 14:30:00 +0800 (RFC 2828)
?>
<?php
// mktime(時, 分, 秒, 月, 日, 年)
$tomorrow = mktime(0, 0, 0, date('m'), date('d') + 1, date('Y'));
echo "明天是 " . date('Y/m/d', $tomorrow);
// 指定日期
$birthday = mktime(0, 0, 0, 5, 20, 1990);
echo "生日:" . date('Y-m-d', $birthday);
?>
<?php
echo strtotime('now'); // 當前時間戳
echo strtotime('+1 day'); // 明天
echo strtotime('next Monday'); // 下週一
echo strtotime('last day of February 2024'); // 2024-02-29 (閏年)
echo strtotime('first day of this month'); // 本月 1 號
echo strtotime('-1 month'); // 一個月前
echo strtotime('2024-12-25 10:00:00'); // 指定日期時間
?>
<?php
// 建立
$dt = new DateTime(); // 現在
$dt = new DateTime('2024-12-25'); // 指定日期
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei')); // 指定時區
// 格式化
echo $dt->format('Y-m-d H:i:s');
// 修改
$dt->modify('+1 week');
$dt->add(new DateInterval('P1M')); // 加 1 月
$dt->sub(new DateInterval('P3D')); // 減 3 天
$dt->setTime(12, 0, 0); // 設定時間
// 比較
$dt1 = new DateTime('2024-01-01');
$dt2 = new DateTime('2024-12-31');
$diff = $dt1->diff($dt2);
echo $diff->days; // 365
// 時區轉換
$dt->setTimezone(new DateTimeZone('UTC'));
echo $dt->format('Y-m-d H:i:s T');
?>
<?php
// 設定預設時區(建議在 bootstrap/啟動檔案設定一次)
date_default_timezone_set('Asia/Taipei');
// 或在 php.ini
// date.timezone = Asia/Taipei
// 取得支援時區清單
print_r(DateTimeZone::listIdentifiers());
?>
E_WARNING 並使用 UTC。date() 使用預設時區,DateTime 可各實例指定時區。跨時區系統統一儲存 UTC,顯示時轉換用戶時區。
<?php
echo date(DATE_ATOM); // 2024-01-15T14:30:00+08:00 (ISO 8601)
echo date(DATE_COOKIE); // Monday, 15-Jan-2024 14:30:00 CST
echo date(DATE_ISO8601); // 2024-01-15T14:30:00+0800
echo date(DATE_RFC822); // Mon, 15 Jan 24 14:30:00 +0800
echo date(DATE_RFC850); // Monday, 15-Jan-24 14:30:00 CST
echo date(DATE_RFC1036); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC1123); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC2822); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_RFC3339); // 2024-01-15T14:30:00+08:00
echo date(DATE_RSS); // Mon, 15 Jan 2024 14:30:00 +0800
echo date(DATE_W3C); // 2024-01-15T14:30:00+08:00
?>