date() 是 PHP 最常用的日期時間格式化函數,其第一個參數「格式字串」由多個字符組合而成。官方文檔分類較散,本文將所有格式字符按功能分組整理,附帶說明與範例輸出,方便開發隨時查閱。
📅 日期相關
| 字符 | 說明 | 範例輸出 |
d | 月份中的第幾天,雙位數(前導零) | 01 到 31 |
j | 月份中的第幾天,無前導零 | 1 到 31 |
S | 英文序數後綴(配合 j 使用) | st, nd, rd, th |
z | 年份中的第幾天(從 0 開始) | 0 到 365 |
📆 星期相關
| 字符 | 說明 | 範例輸出 |
l (小寫 L) | 星期幾完整英文名 | Sunday 到 Saturday |
D | 星期幾三字母縮寫 | Mon 到 Sun |
N | ISO-8601 數字表示(PHP 5.1.0+) | 1(週一) 到 7(週日) |
w | 數字表示(0=週日) | 0 到 6 |
W | ISO-8601 年份第幾週(週一開始,PHP 4.1.0+) | 例:42 |
🗓️ 月份相關
| 字符 | 說明 | 範例輸出 |
F | 月份完整英文名 | January 到 December |
m | 數字月份,雙位數(前導零) | 01 到 12 |
M | 三字母縮寫月份 | Jan 到 Dec |
n | 數字月份,無前導零 | 1 到 12 |
t | 給定月份總天數 | 28 到 31 |
📅 年份相關
| 字符 | 說明 | 範例輸出 |
L | 是否閏年 | 1=是, 0=否 |
o | ISO-8601 年份(配合 W 使用,PHP 5.1.0+) | 1999, 2003 |
Y | 四位數完整年份 | 1999, 2003 |
y | 兩位數年份 | 99, 03 |
⏰ 時間相關
| 字符 | 說明 | 範例輸出 |
a | 小寫上午/下午 | am, pm |
A | 大寫上午/下午 | AM, PM |
B | Swatch Internet Time | 000 到 999 |
g | 12小時制,無前導零 | 1 到 12 |
G | 24小時制,無前導零 | 0 到 23 |
h | 12小時制,雙位數 | 01 到 12 |
H | 24小時制,雙位數 | 00 到 23 |
i | 分鐘,雙位數 | 00 到 59 |
s | 秒,雙位數 | 00 到 59 |
u | 微秒(PHP 5.2.2+,date() 不支持,需用 DateTime) | 654321 |
🌍 時區相關
| 字符 | 說明 | 範例輸出 |
e | 時區標識(PHP 5.1.0+) | UTC, GMT, Asia/Shanghai |
I (大寫 i) | 是否夏令時 | 1=是, 0=否 |
O | 與 GMT 時差(小時) | +0800 |
P | 與 GMT 時差(冒號分隔,PHP 5.1.3+) | +08:00 |
T | 本機時區縮寫 | CST, EST, MDT |
Z | 時差偏移秒數(UTC 西負東正) | -43200 到 43200 |
📄 完整日期/時間常用組合
| 字符 | 說明 | 範例輸出 |
c | ISO 8601 格式(PHP 5+) | 2004-02-12T15:19:21+00:00 |
r | RFC 822/2822 格式 | Thu, 21 Dec 2000 16:01:07 +0200 |
U | Unix 時間戳(秒數) | 1704067200 |
💡 實用組合範例
<?php
$now = time(); // 或 new DateTime()
// 常見格式
echo date('Y-m-d H:i:s', $now); // 2024-01-01 12:30:45
echo date('Y/m/d', $now); // 2024/01/01
echo date('Y年m月d日 l', $now); // 2024年01月01日 Monday
echo date('Y-m-d\TH:i:sP', $now); // 2024-01-01T12:30:45+08:00 (ISO 8601)
echo date('D, d M Y H:i:s O', $now); // Mon, 01 Jan 2024 12:30:45 +0800 (RFC 2822)
// 避坑:格式字串中非格式字符需轉義或用單引號包裹
echo date('Y-m-d', $now); // 正確
echo date("Y-m-d", $now); // 正確(雙引號裡變量會解析,但這裡無變量)
// echo date(Y-m-d, $now); // ❌ 錯誤:常量未定義,會觸發 Notice
?>
⚠️ 重要提醒
- 時區設置: 請在
php.ini 設 date.timezone = "Asia/Shanghai" 或腳本開頭 date_default_timezone_set('Asia/Shanghai');,否則會觸發 E_WARNING 且時間可能偏移。
- 微秒支持:
date() 不支持 u,需用 DateTime::format('u') 或 microtime(true)。
- Windows 時區名:
T 在 Windows 下返回完整名稱(如 "China Standard Time"),Linux 下返回縮寫(CST)。
- 性能: 高頻調用時,優先用
DateTime 物件複用,避免重複解析格式字串。
🔗 相關函數速查
strtotime():英文文本時間 → 時間戳
mktime():日期參數 → 時間戳
getdate():時間戳 → 關聯陣列
gmdate():GMT/UTC 格式化
DateTime 類:物件導向、時區轉換、微秒、不可變 DateTimeImmutable
收藏此表,以後寫 date() 格式字串再也不用查文檔!