PHP date() 只能輸出英文格式,需自行組合中文年月日時分秒。PHP 5.3+ 強制要求設定時區,否則拋出警告。本文提供中文日期格式化函數、時區設定三種方法、完整格式字元參考表與 IntlDateFormatter 現代化方案。
function chineseDate(string $format = 'Y年m月d日 H時i分s秒', ?int $timestamp = null): string {
$timestamp ??= time();
$replacements = [
'Y' => date('Y', $timestamp), // 4位年
'y' => date('y', $timestamp), // 2位年
'm' => date('m', $timestamp), // 2位月
'n' => date('n', $timestamp), // 無前導零月
'd' => date('d', $timestamp), // 2位日
'j' => date('j', $timestamp), // 無前導零日
'H' => date('H', $timestamp), // 24小時制
'G' => date('G', $timestamp), // 無前導零24小時
'h' => date('h', $timestamp), // 12小時制
'g' => date('g', $timestamp), // 無前導零12小時
'i' => date('i', $timestamp), // 分鐘
's' => date('s', $timestamp), // 秒
'a' => date('a', $timestamp), // am/pm
'A' => date('A', $timestamp), // AM/PM
'w' => ['日','一','二','三','四','五','六'][(int)date('w', $timestamp)], // 星期
'l' => ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'][(int)date('w', $timestamp)],
];
return strtr($format, $replacements);
}
// 使用
echo chineseDate(); // 2024年05月23日 14時30分45秒
echo chineseDate('Y年n月j日 l'); // 2024年5月23日 星期四
ini_set('date.timezone', 'Asia/Shanghai');
; php.ini
date.timezone = "Asia/Shanghai"
; 或
date.timezone = "PRC"
Asia/Taipei // 台灣 (CST, UTC+8, 無夏令時間)
Asia/Shanghai // 中國大陸
Asia/Hong_Kong // 香港
Asia/Singapore // 新加坡
America/New_York // 美東 (EST/EDT, 有夏令時間)
Europe/London // 英國 (GMT/BST, 有夏令時間)
UTC // 世界協調時間
| 字元 | 說明 | 範例 |
|---|---|---|
| Y | 4位數年份 | 2024 |
| y | 2位數年份 | 24 |
| m | 月份 (01-12) | 05 |
| n | 月份 (1-12) | 5 |
| F | 月份完整英文名 | May |
| M | 月份縮寫 (3字母) | May |
| d | 日期 (01-31) | 23 |
| j | 日期 (1-31) | 23 |
| D | 星期縮寫 (3字母) | Thu |
| l | 星期完整英文名 | Thursday |
| w | 星期數字 (0=週日, 6=週六) | 4 |
| N | ISO-8601 星期 (1=週一, 7=週日) | 4 |
| z | 年間第幾天 (0-365) | 143 |
| W | 年間第幾週 (ISO-8601, 週一開始) | 21 |
| t | 該月總天數 | 31 |
| L | 是否閏年 (1/0) | 1 |
| H | 24小時制 (00-23) | 14 |
| G | 24小時制 (0-23) | 14 |
| h | 12小時制 (01-12) | 02 |
| g | 12小時制 (1-12) | 2 |
| i | 分鐘 (00-59) | 30 |
| s | 秒數 (00-59) | 45 |
| u | 微秒 (PHP 5.2.2+) | 123456 |
| e | 時區識別符 | Asia/Taipei |
| O | 與 GMT 時差 (小時) | +0800 |
| P | 與 GMT 時差 (時:分) | +08:00 |
| T | 本機時區縮寫 | CST |
| Z | 時差秒數 (負為西區) | 28800 |
| c | ISO 8601 格式 | 2024-05-23T14:30:45+08:00 |
| r | RFC 2822 格式 | Thu, 23 May 2024 14:30:45 +0800 |
| U | Unix 時間戳 | 1716445845 |
支援多語系、地區化格式、相對時間、時區轉換,是現代專案的標準選擇。
format(time());
// 2024年5月23日 星期四 下午02時30分45秒 CST
// 自定義模式
$fmt->setPattern('yyyy年MM月dd日 HH時mm分ss秒');
echo $fmt->format(time());
// 2024年05月23日 14時30分45秒
// 相對時間格式化 (PHP 8.0+)
$rel = new IntlRelativeTimeFormatter('zh_TW');
echo $rel->format(-1, IntlRelativeTimeFormatter::DAY); // 昨天
echo $rel->format(3, IntlRelativeTimeFormatter::HOUR); // 3小時後
// strtotime 相對時間
strtotime('+1 day'); // 明天這時
strtotime('next Monday'); // 下週一
strtotime('first day of this month'); // 本月1號
strtotime('last day of -1 month'); // 上月最後一天
// DateTime 物件導向 (推薦)
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));
$dt->modify('+1 month');
echo $dt->format('Y-m-d H:i:s');
// 日期差
$dt1 = new DateTime('2024-01-01');
$dt2 = new DateTime('2024-12-31');
$diff = $dt1->diff($dt2);
echo $diff->days; // 365
echo $diff->format('%y年%m月%d天');
中文日期格式化:簡單場景用 strtr 替換,複雜多語系用 IntlDateFormatter。時區設定:**專案入口統一 date_default_timezone_set()**,不要依賴 php.ini (容器化部署時環境變數 TZ 更佳)。棄用 date() 進行運算,改用 DateTime / DateTimeImmutable 物件導向 API,避免時區、夏令時間、閏秒等陷阱。