PHP 5.1.0 起引入 `date.timezone` 設定,預設使用 UTC (格林威治標準時間)。台灣/中國大陸/香港/新加坡位於 **UTC+8 (Asia/Shanghai)**,若未正確設定時區,`date()`、`time()`、`DateTime` 等函式輸出會比本地時間**少 8 小時**。本文提供三種解決方案與最佳實務。
<?php
// 未設定時區時
echo date('Y-m-d H:i:s'); // 2024-01-15 03:30:00 (UTC)
// 實際本地時間: 2024-01-15 11:30:00 (UTC+8)
// 差異: 8 小時
?>
; php.ini
date.timezone = "Asia/Shanghai" ; 中國大陸、台灣、香港、新加坡
; date.timezone = "Asia/Taipei" ; 台灣專用 (相同 UTC+8,但有夏令時間歷史差異)
; date.timezone = "Asia/Hong_Kong" ; 香港
; date.timezone = "Asia/Macao" ; 澳門
; date.timezone = "Asia/Singapore" ; 新加坡
修改後**必須重啟 Web 伺服器** (Apache/Nginx + PHP-FPM) 生效。
<?php
// 在所有日期時間操作之前呼叫 (建議放在共用設定檔/啟動檔)
date_default_timezone_set('Asia/Shanghai');
// 後續所有 date(), time(), new DateTime() 皆使用正確時區
echo date('Y-m-d H:i:s'); // 正確輸出本地時間
?>
優點:部署靈活、跨時區部署友好。缺點:每個入口點都需包含,易漏設。
<?php
// 建立指定時區的 DateTime
$dt = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
echo $dt->format('Y-m-d H:i:s'); // 正確本地時間
// 從 UTC 時間轉換
$utc = new DateTime('2024-01-15 03:30:00', new DateTimeZone('UTC'));
$utc->setTimezone(new DateTimeZone('Asia/Shanghai'));
echo $utc->format('Y-m-d H:i:s'); // 2024-01-15 11:30:00
// 格式化輸出 (支援微秒、ISO8601、RFC3339 等)
echo $dt->format('Y-m-d H:i:s.u'); // 含微秒
echo $dt->format(DateTime::ISO8601); // 2024-01-15T11:30:00+0800
echo $dt->format(DateTime::RFC3339); // 2024-01-15T11:30:00+08:00
| 地區 | 時區識別碼 | UTC 偏移 | 備註 |
|---|---|---|---|
| 中國大陸/台灣/香港/澳門/新加坡/馬來西亞/菲律賓/西澳 | Asia/Shanghai | +08:00 | 無夏令時間,通用推薦 |
| 台灣 | Asia/Taipei | +08:00 | 歷史上曾有夏令時間,現同 Shanghai |
| 日本/韓國 | Asia/Tokyo / Asia/Seoul | +09:00 | |
| 泰國/越南/印尼西部 | Asia/Bangkok | +07:00 | |
| 印度 | Asia/Kolkata | +05:30 | 半小時偏移 |
| 阿聯酋/波斯灣 | Asia/Dubai | +04:00 |
| 現象 | 原因 | 解決 |
|---|---|---|
| date() 警告: "It is not safe to rely on system's timezone settings" | 未設定 date.timezone | 設定 php.ini 或 date_default_timezone_set() |
| 資料庫 TIMESTAMP 欄位自動轉換 | MySQL TIMESTAMP 儲存為 UTC,讀取轉為 session 時區 | 統一使用 DATETIME + 應用層處理,或設定 SQL 模式 |
| strtotime() 解析相對時間錯誤 | 預設使用當前時區 | 確保 date_default_timezone_set() 已呼叫 |
| DateTime::createFromFormat 解析無時區字串 | 預設使用預設時區 | 明確指定時區: `new DateTimeZone('UTC')` |