核心函數
<?php
/**
* 時區轉換
* @param string $src 源時間字符串(格式需與 $fm 一致,默認 Y-m-d H:i:s)
* @param string $from_tz 源時區標識符(如 America/Denver)
* @param string $to_tz 目標時區標識符(如 Asia/Shanghai)
* @param string $fm 輸出格式
* @return string 轉換後的時間字符串
*/
function toTimeZone($src, $from_tz = 'America/Denver', $to_tz = 'Asia/Shanghai', $fm = 'Y-m-d H:i:s') {
$datetime = new DateTime($src, new DateTimeZone($from_tz));
$datetime->setTimezone(new DateTimeZone($to_tz));
return $datetime->format($fm);
}
// 示例
echo toTimeZone('2023-10-01 12:00:00', 'America/New_York', 'Asia/Shanghai');
// 輸出: 2023-10-02 00:00:00 (夏令時期間相差12小時)
?>
常用時區標識符
- 中國:
Asia/Shanghai(無夏令時,UTC+8)
- 美國東部:
America/New_York(EST/EDT)
- 美國西部:
America/Los_Angeles(PST/PDT)
- 歐洲中部:
Europe/Berlin(CET/CEST)
- UTC:
UTC 或 GMT
- 完整列表見
DateTimeZone::listIdentifiers()。
進階:用戶時區自動檢測與存儲
<?php
// 1. 前端 JS 獲取用戶時區
// Intl.DateTimeFormat().resolvedOptions().timeZone -> "Asia/Shanghai"
// 發送至後端存入用戶表 user.timezone
// 2. 後端統一存儲 UTC
function saveUserTime($userId, $localTime, $userTimezone) {
$utcTime = toTimeZone($localTime, $userTimezone, 'UTC', 'Y-m-d H:i:s');
// 存入數據庫:$utcTime (DATETIME/TIMESTAMP)
}
// 3. 讀取時轉換為用戶時區
function getUserTime($userId, $utcTimeFromDb) {
$userTz = getUserTimezone($userId); // 從數據庫/緩存獲取
return toTimeZone($utcTimeFromDb, 'UTC', $userTz);
}
// 4. PHP 全局設置(僅影響 date() 等函數,不影響 DateTime)
date_default_timezone_set('UTC'); // 建議項目統一使用 UTC
?>
常見坑與避坑指南
| 坑點 | 後果 | 解決 |
| 直接用 date() + 時區偏移秒數計算 | 夏令時切換導致錯誤 1 小時 | 必須用 DateTimeZone 自動處理夏令時規則 |
| 數據庫 TIMESTAMP 與 DATETIME 混用 | TIMESTAMP 自動轉換為服務器時區,DATETIME 不轉換 | 統一用 DATETIME 存儲 UTC,應用層轉換 |
| strtotime() 解析無時區字符串 | 按 php.ini date.timezone 解析,易混淆 | 總是傳入帶時區字符串或用 DateTime |
| 夏令時重複/缺失小時 | 如 2023-11-05 01:00-02:00 發生兩次 | 業務邏輯避開該時段,或用 UTC 存儲計算 |
最佳實踐清單
- 項目啟動時 `date_default_timezone_set('UTC')`。
- 數據庫存儲 `DATETIME` 類型 UTC 時間。
- 所有時間計算、比較在 UTC 進行。
- 僅在**展示給用戶時**轉換為用戶時區。
- 用戶時區通過 JS 檢測獲取,存入用戶表。
- 定時任務、日誌、API 交互均使用 UTC。