萬盛學電腦網

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

PHP 時區轉換函數:DateTimeZone 實現跨時區時間轉換

核心函數

<?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 存儲計算

最佳實踐清單

  1. 項目啟動時 `date_default_timezone_set('UTC')`。
  2. 數據庫存儲 `DATETIME` 類型 UTC 時間。
  3. 所有時間計算、比較在 UTC 進行。
  4. 僅在**展示給用戶時**轉換為用戶時區。
  5. 用戶時區通過 JS 檢測獲取,存入用戶表。
  6. 定時任務、日誌、API 交互均使用 UTC。
copyright © 萬盛學電腦網 all rights reserved