萬盛學電腦網

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

PHP 時區管理:date_default_timezone_get/set 獲取與設定默認時區完整指南

date_default_timezone_get()

date_default_timezone_get(): string

返回腳本中所有日期時間函數使用的默認時區標識符(如 Asia/Taipei、UTC)。

解析優先順序

  1. date_default_timezone_set() 設定的時區
  2. 環境變數 TZ
  3. php.ini date.timezone
  4. 系統推測(/etc/localtime、註冊表等)
  5. 兜底返回 UTC

date_default_timezone_set()

date_default_timezone_set(string $timezone): bool

設定腳本運行期間的默認時區。成功返回 true,失敗(時區標識符無效)返回 false 並拋出 E_WARNING。

常用時區標識符

地區標識符UTC 偏移
台灣/香港/澳門/北京/上海Asia/Shanghai+08:00
台北Asia/Taipei+08:00
東京Asia/Tokyo+09:00
新加坡/吉隆坡Asia/Singapore+08:00
倫敦Europe/London+00:00/+01:00 (DST)
紐約America/New_York-05:00/-04:00 (DST)
UTCUTC+00:00

完整列表見 PHP 官方時區列表。

最佳實踐

  1. 專案啟動階段統一設定(bootstrap、config、框架入口):
    date_default_timezone_set('Asia/Taipei');
  2. php.ini 全域設定(推薦生產環境):
    date.timezone = "Asia/Taipei"
  3. 避免在函數/方法內重複呼叫,效能微損且易亂序。
  4. 儲存時間戳(INT)而非格式化字串,顯示時再依用戶時區格式化。

錯誤處理

if (!@date_default_timezone_set($userTz)) {
    // 無效時區,回退預設
    date_default_timezone_set('UTC');
    log_warning("Invalid timezone: $userTz");
}

PHP 5.1+ 時區無效會拋 E_WARNING,@ 抑制後用返回值判斷。

DateTimeZone 物件導向(PHP 5.2+)

$tz = new DateTimeZone('Asia/Taipei');
$dt = new DateTime('now', $tz);
echo $dt->format('Y-m-d H:i:s T'); // 2024-02-29 15:30:00 CST
copyright © 萬盛學電腦網 all rights reserved