PHP date() 格式化字符完整對照表 (含 ISO 8601、RFC 2822、Unix 時間戳)

`date()`、`DateTime::format()`、`strftime()` 共用格式字符，但細節不同。本文提供**最完整、最實用**的對照表，按功能分組，含輸出示例、常見陷阱、DateTime 不可變對象用法、時區處理、效能對比。

完整格式字符對照表

常用組合模板 (可直接複製)

<?php
$now = new DateTime(); // 推薦用 DateTime 不可變對象

// 日志文件名
$logFile = 'app-' . $now->format('Ymd_His') . '.log'; // 20240115_143000.log

// 數據庫 DATETIME
$dbTime = $now->format('Y-m-d H:i:s'); // 2024-01-15 14:30:00

// 前端顯示 (中文)
$display = $now->format('Y年m月d日 H:i'); // 2024年01月15日 14:30

// ISO 8601 (API 交換標準)
$iso = $now->format(DateTime::ATOM); // 2024-01-15T14:30:00+08:00
// 或
$iso = $now->format('c');

// RFC 2822 (Email Date 頭)
$rfc2822 = $now->format(DateTime::RFC2822); // Mon, 15 Jan 2024 14:30:00 +0800
// 或
$rfc2822 = $now->format('r');

// 帶微秒高精度 (日志追蹤)
$precise = $now->format('Y-m-d H:i:s.u'); // 2024-01-15 14:30:00.123456

// 自定義格式
$custom = $now->format('l, F jS, Y \a\t g:i A'); // Monday, January 15th, 2024 at 2:30 PM
?>

DateTime 不可變對象最佳實踐 (PHP 5.5+)

<?php
// 建立
$dt = new DateTimeImmutable('now', new DateTimeZone('Asia/Shanghai'));

// 修改返回新對象，原對象不變 (線程安全、鏈式調用)
$tomorrow = $dt->add(new DateInterval('P1D'));
$nextWeek = $dt->modify('+1 week');
$startOfMonth = $dt->modify('first day of this month')->setTime(0,0,0);

// 格式化
echo $dt->format('c');

// 比較
if ($dt1 > $dt2) { ... }
$diff = $dt1->diff($dt2); // DateInterval
echo $diff->days; // 相差天數

// 時區轉換 (不改變時間點，僅顯示變化)
$utc = $dt->setTimezone(new DateTimeZone('UTC'));
echo $utc->format('c'); // 同一時刻的 UTC 表示
?>

常見陷阱與避坑指南

效能對比 (百萬次格式化)

PHP 8.1+ 新增：DateTimeImmutable::createFromInterface()

<?php
// 任意實現 DateTimeInterface 的對象互轉
$dt = DateTimeImmutable::createFromInterface($carbonInstance); // Laravel Carbon
$dt = DateTimeImmutable::createFromInterface($chronoDate);     // cakephp/chrono
// 統一內部使用 DateTimeImmutable，邊界層轉換
?>