PHP date() 日期時間格式化完整指南：格式字元、時間戳、進階函數與時區

date() 是 PHP 最常用的日期格式化函數，支援豐富的格式字元。本文整理完整格式字元表、時間戳操作、常用進階函數 (strtotime, DateTime, microtime 等)、時區處理最佳實踐，並提供可直接使用的格式化速查表。

date() 格式字元完整速查表

常用格式組合範例

<?php
$now = time();

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分', $now); // 2024年01月15日 14時30分
echo date('l, F jS, Y', $now);      // Monday, January 15th, 2024
echo date('D, d M Y H:i:s T', $now); // Mon, 15 Jan 2024 14:30:00 CST
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 2822)
?>

時間戳操作

mktime() / gmmktime() - 建立時間戳

<?php
// 本地時間建立
$ts = mktime(14, 30, 0, 1, 15, 2024); // 2024-01-15 14:30:00 (本地時區)
echo date('Y-m-d H:i:s', $ts);

// UTC 時間建立
$utcTs = gmmktime(6, 30, 0, 1, 15, 2024); // 2024-01-15 06:30:00 UTC
echo gmdate('Y-m-d H:i:s', $utcTs);

// 明天這個時間
$tomorrow = mktime(date('H'), date('i'), date('s'), date('m'), date('d')+1, date('Y'));
?>

strtotime() - 自然語言解析

<?php
echo date('Y-m-d', strtotime('tomorrow'));           // 明天
echo date('Y-m-d', strtotime('next Monday'));        // 下週一
echo date('Y-m-d', strtotime('+1 week 3 days'));     // 1 週又 3 天後
echo date('Y-m-d', strtotime('first day of next month')); // 下月 1 號
echo date('Y-m-d', strtotime('last day of February 2024')); // 2024-02-29 (閏年)
?>

getdate() - 時間戳轉關聯陣列

<?php
$arr = getdate(); // 當前時間
// 或 $arr = getdate($timestamp);
echo "Date: {$arr['mday']} {$arr['month']} {$arr['year']}";
echo "Time: {$arr['hours']}:{$arr['minutes']}:{$arr['seconds']}";
// 可用鍵: seconds, minutes, hours, mday, wday, mon, year, yday, weekday, month, 0 (時間戳)
?>

進階日期時間函數

DateTime 現代用法 (PHP 5.2+，推薦)

<?php
// 建立
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));
$dt = new DateTime('2024-01-15 14:30:00');
$dt = DateTime::createFromFormat('Y/m/d H:i', '2024/01/15 14:30');

// 格式化
echo $dt->format('Y-m-d H:i:s');
echo $dt->format(DateTime::ATOM); // 常數

// 時區轉換 (核心優勢)
$utc = clone $dt;
$utc->setTimezone(new DateTimeZone('UTC'));
echo $utc->format('Y-m-d H:i:s');

// 日期運算
$dt->modify('+1 week');
$dt->modify('first day of this month');
$dt->add(new DateInterval('P1M')); // 1 個月
$dt->sub(new DateInterval('P3D')); // 3 天

// 差值
$diff = $dt1->diff($dt2);
echo $diff->format('%a 天 %h 小時 %i 分鐘');

// 比較
if ($dt1 > $dt2) { ... }
if ($dt1 == $dt2) { ... }

// 不可變版本 (PHP 5.5+，推薦避免副作用)
$immutable = new DateTimeImmutable('now');
$nextWeek = $immutable->modify('+1 week'); // 回傳新物件，原物件不變
?>

時區處理最佳實踐 (必讀)

1. php.ini 設定：date.timezone = "Asia/Taipei" (或系統時區)
2. 儲存/運算用 UTC：資料庫存 TIMESTAMP (UTC) 或 BIGINT 時間戳
3. 顯示時轉換：用 DateTime::setTimezone() 轉換為使用者時區
4. 避免手動秒數偏移：time() + 3600*8 夏令時間會錯

常見格式化需求速查