| 函數 | 描述 | 時區依賴 | 返回值基準 |
|---|---|---|---|
date() | 格式化本地時間 | 受 date.timezone 影響 | 當前時區時間 |
gmdate() | 格式化 GMT/UTC 時間 | 不受時區設置影響 | 格林威治標準時間 |
<?php
date_default_timezone_set('Asia/Shanghai'); // UTC+8
echo "date(): " . date('Y-m-d H:i:s') . "\n"; // 2024-01-15 12:00:00 (本地時間)
echo "gmdate(): " . gmdate('Y-m-d H:i:s') . "\n"; // 2024-01-15 04:00:00 (UTC 時間)
echo "time(): " . time() . "\n"; // 1705291200 (UTC 時間戳,不變)
?>
歷史問題:PHP 5.1 之前,Windows 下 date() 也返回 UTC 時間,導致跨平台不一致。
現狀:PHP 5.1+ 統一行為,date() 依賴 date.timezone,gmdate() 恒為 UTC。
; php.ini
date.timezone = "Asia/Shanghai"
; 或 PRC, Asia/Chongqing, Etc/GMT-8
<?php
// 入口文件最早位置設置
date_default_timezone_set('Asia/Shanghai');
// 或者運行時動態(不推薦頻繁切換)
ini_set('date.timezone', 'America/New_York');
<?php
// 數據庫存儲:統一存儲 UTC 時間戳 (INT) 或 UTC DATETIME
// 顯示時:根據用戶設置轉換
$userTimezone = 'America/Los_Angeles'; // 用戶設置
$utcTimestamp = time(); // 或從數據庫讀取
// 方法 1:DateTime (推薦,面向對象、不可變)
$dt = new DateTime("@$utcTimestamp"); // UTC 時間
$dt->setTimezone(new DateTimeZone($userTimezone));
echo $dt->format('Y-m-d H:i:s T'); // 2024-01-14 20:00:00 PST
// 方法 2:gmdate + 偏移計算(不推薦,夏令時易錯)
// $offset = timezone_offset_get(new DateTimeZone($userTimezone), new DateTime());
// echo gmdate('Y-m-d H:i:s', $utcTimestamp + $offset);
?>
time():UTC 時間戳(自 1970-01-01 00:00:00 UTC 經過的秒數),與時區無關strtotime():解析字符串為 UTC 時間戳,解析過程受當前時區影響<?php
date_default_timezone_set('UTC');
echo strtotime('1970-01-01 08:00:00'); // 28800 (8小時=28800秒)
date_default_timezone_set('Asia/Shanghai');
echo strtotime('1970-01-01 08:00:00'); // 0 (當地時間08:00 = UTC 00:00)
?>
| 場景 | 存儲 | 顯示 | 關鍵點 |
|---|---|---|---|
| 日誌/審計 | UTC 時間戳 (BIGINT) | 管理員時區 / UTC | 統一時間線,便於跨時區排查 |
| 用戶內容發布 | UTC DATETIME / TIMESTAMP | 用戶所在時區 | 前端傳用戶時區,後端轉換 |
| 定時任務 | UTC Cron 表達式 | 服務器時區執行 | 避免夏令時重複/跳過執行 |
| 跨系統同步 | ISO 8601 字符串 (2024-01-15T04:00:00Z) | 各系統自行轉換 | 明確時區標識 Z/+00:00 |
<?php
// 創建
$dt = new DateTime(); // 當前時間,默認時區
$dt = new DateTime('now', new DateTimeZone('UTC')); // 指定時區
$dt = DateTime::createFromFormat('Y-m-d H:i:s', '2024-01-15 12:00:00', new DateTimeZone('Asia/Shanghai'));
// 格式化
echo $dt->format('Y-m-d H:i:s T'); // 2024-01-15 12:00:00 CST
// 時區轉換(不修改原對象,返回新對象 PHP 5.5+)
$utc = $dt->setTimezone(new DateTimeZone('UTC'));
echo $utc->format('Y-m-d H:i:s T'); // 2024-01-15 04:00:00 UTC
// 計算差值
$diff = $dt1->diff($dt2);
echo $diff->format('%a天 %h小時 %i分'); // 間隔
// 修改
$dt->modify('+1 day')->setTime(0,0,0); // 明天零點
// 不可變版本 (PHP 5.5+)
$immutable = new DateTimeImmutable('now');
$tomorrow = $immutable->modify('+1 day'); // 返回新對象,原對象不變
?>
TIMESTAMP (自動 UTC↔當前時區) 或 BIGINT 時間戳date_default_timezone_set('Asia/Shanghai')gmdate() + 3600*8 會在夏令時出錯Asia/Shanghai,非 GMT+8(不含夏令時規則)時區處理的核心原則:內部統一 UTC,邊界按需轉換。DateTime 類是現代 PHP 時區處理的正確工具。