萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 日期時間處理:解決「差 8 小時」時區問題的三種方案

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 (一勞永逸、推薦生產環境)

; 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.ini 時)

<?php
// 在所有日期時間操作之前呼叫 (建議放在共用設定檔/啟動檔)
date_default_timezone_set('Asia/Shanghai');

// 後續所有 date(), time(), new DateTime() 皆使用正確時區
echo date('Y-m-d H:i:s'); // 正確輸出本地時間
?>

優點:部署靈活、跨時區部署友好。缺點:每個入口點都需包含,易漏設。

方案三:使用 DateTime 物件指定時區 (現代最佳實務)

<?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

DateTimeZone 常用時區識別碼 (亞洲地區)

進階:使用者時區偵測與個人化顯示

<?php
// 1. 註冊/設定檔讓使用者選擇時區
$userTimezone = 'America/New_York'; // 從資料庫讀取

// 2. 後端儲存一律使用 UTC
$createdAt = new DateTime('now', new DateTimeZone('UTC'));
// 儲存 $createdAt->format('Y-m-d H:i:s') 至資料庫 (DATETIME/TIMESTAMP)

// 3. 顯示時轉換為使用者時區
function formatForUser(DateTime $utcDateTime, string $userTz, string $format = 'Y-m-d H:i:s'): string
{
    $dt = clone $utcDateTime;
    $dt->setTimezone(new DateTimeZone($userTz));
    return $dt->format($format);
}

echo formatForUser($createdAt, $userTimezone); // 使用者本地時間
?>

前端 JavaScript 協助偵測使用者時區

<script>
// 取得 IANA 時區識別碼 (如 "Asia/Taipei", "America/New_York")
const userTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
// 發送至後端儲存
fetch('/api/user/timezone', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({timezone: userTimezone})
});
</script>

常見陷阱與除錯技巧

地區時區識別碼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')`

檢查清單 (部署前必驗)

  1. ☐ `php.ini` 設定 `date.timezone = "Asia/Shanghai"` 並重啟服務
  2. ☐ 程式碼入口點 (index.php, bootstrap.php) 呼叫 `date_default_timezone_set('Asia/Shanghai')`
  3. ☐ 所有新代碼使用 `DateTime` + `DateTimeZone` 替代 `date()`/`strtotime()`
  4. ☐ 資料庫連線設定時區: `SET time_zone = '+08:00'` 或使用 UTC 儲存
  5. ☐ 日誌、API 回應、排程任務 時間格式統一為 ISO 8601 / RFC 3339
copyright © 萬盛學電腦網 all rights reserved