傳統 date() 格式字元速查
| 字元 | 意義 | 範例 |
| Y | 4 位數年 | 2024 |
| y | 2 位數年 | 24 |
| m | 月份 01-12 | 05 |
| n | 月份 1-12 | 5 |
| d | 日期 01-31 | 20 |
| j | 日期 1-31 | 20 |
| H | 24 小時 00-23 | 14 |
| h | 12 小時 01-12 | 02 |
| i | 分鐘 00-59 | 30 |
| s | 秒數 00-59 | 05 |
| u | 微秒 (PHP 5.2.2+) | 123456 |
| w | 星期 0(日)-6(六) | 1 |
| D | 星期縮寫 | Mon |
| l | 星期全名 | Monday |
| W | 年度第幾週 | 21 |
| t | 當月天數 | 31 |
| z | 年度第幾天 0-365 | 140 |
| U | Unix 時間戳 | 1716187805 |
| c | ISO 8601 | 2024-05-20T14:30:05+08:00 |
| r | RFC 2822 | Mon, 20 May 2024 14:30:05 +0800 |
DateTime 物件導向用法(推薦)
$dt = new DateTimeImmutable('now', new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s'); // 2024-05-20 14:30:05
echo $dt->format('c'); // ISO 8601
echo $dt->getTimestamp(); // Unix timestamp
// 日期運算
$tomorrow = $dt->add(new DateInterval('P1D'));
$lastMonth = $dt->sub(new DateInterval('P1M'));
$nextFriday = $dt->modify('next friday');
// 差值
$diff = $dt->diff(new DateTimeImmutable('2024-12-31'));
echo $diff->format('%a 天 %h 小時 %i 分鐘');
常用靜態建構子
DateTime::createFromFormat('Y-m-d', '2024-05-20'):指定格式解析
DateTimeImmutable::createFromInterface():從任意介面建立
date_create_immutable_from_format():程序式對應
時間戳互轉
$ts = time(); // 當前秒數
$ts = microtime(true); // 含微秒浮點數
$dt = DateTimeImmutable::createFromFormat('U.u', sprintf('%.6f', $ts)); // 微秒還原
時區最佳實務
- 腳本開頭
date_default_timezone_set('Asia/Taipei');
- 資料庫儲存 **UTC**(
TIMESTAMP 或 DATETIME + 應用層統一 UTC)。
- 顯示時依用戶偏好時區轉換(
$dt->setTimezone($userTz))。
- 不要靠伺服器系統時區,容器化部署時區常為 UTC。
PHP 8.1+ 新功能
DateTimeInterface::format() 支援 !v (毫秒)、!u (微秒) 格式字元。
DateTimeZone::getTransitions() 取得時區轉換歷史。
date_parse() 回傳結構化陣列,替代 strptime()。