萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP date() 格式化字符完整對照表(含說明與範例輸出)

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
NISO-8601 數字表示(PHP 5.1.0+)1(週一) 到 7(週日)
w數字表示(0=週日)0 到 6
WISO-8601 年份第幾週(週一開始,PHP 4.1.0+)例:42

🗓️ 月份相關

字符說明範例輸出
F月份完整英文名January 到 December
m數字月份,雙位數(前導零)01 到 12
M三字母縮寫月份Jan 到 Dec
n數字月份,無前導零1 到 12
t給定月份總天數28 到 31

📅 年份相關

字符說明範例輸出
L是否閏年1=是, 0=否
oISO-8601 年份(配合 W 使用,PHP 5.1.0+)1999, 2003
Y四位數完整年份1999, 2003
y兩位數年份99, 03

⏰ 時間相關

字符說明範例輸出
a小寫上午/下午am, pm
A大寫上午/下午AM, PM
BSwatch Internet Time000 到 999
g12小時制,無前導零1 到 12
G24小時制,無前導零0 到 23
h12小時制,雙位數01 到 12
H24小時制,雙位數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

📄 完整日期/時間常用組合

字符說明範例輸出
cISO 8601 格式(PHP 5+)2004-02-12T15:19:21+00:00
rRFC 822/2822 格式Thu, 21 Dec 2000 16:01:07 +0200
UUnix 時間戳(秒數)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() 格式字串再也不用查文檔!

copyright © 萬盛學電腦網 all rights reserved