PHP 時間體系深度掌握:從 Unix 時間戳到 DateTime 現代化開發
PHP 日期時間函數眾多且功能重疊,核心在於理解 Unix 時間戳 (自 1970-01-01 00:00:00 UTC 秒數) 與 時區 的概念。本文系統梳理本地時間函數、GMT 函數、驗證、格式化、計算與現代 DateTime 最佳實踐。
核心概念
- Unix Timestamp:整數,跨平台、跨語言、時區無關的絕對時間表示
- Timezone:決定「同一時刻」在不同地區的「本地時間」表達
- PHP 內部存儲:所有時間函數基於 UTC 時間戳運算,輸出時按時區格式化
本地時間函數族
1. date() - 格式化輸出
<?php
echo date("Y年 m月d日"); // 2024年 01月15日
echo date("Y年 m月d日", 60*60*24*365*10); // 1980年 01月01日 (10年後)
?>
2. getdate() - 結構化返回
<?php
$now = getdate();
/* 返回關聯數組:
[
'seconds' => 45, 'minutes' => 30, 'hours' => 14,
'mday' => 15, 'wday' => 1, 'mon' => 1, 'year' => 2024,
'yday' => 14, 'weekday' => 'Monday', 'month' => 'January',
0 => 1705312245 // 時間戳
]
*/
echo $now['hours'] . ':' . $now['minutes'] . ':' . $now['seconds'];
?>
3. checkdate() - 日期合法性驗證
<?php
var_dump(checkdate(2, 29, 2024)); // true (閏年)
var_dump(checkdate(2, 29, 2023)); // false (平年)
var_dump(checkdate(13, 1, 2024)); // false (月份無效)
?>
4. time() - 當前時間戳
<?php
echo time(); // 1705312245
?>
5. mktime() - 組裝時間戳
<?php
// mktime(時, 分, 秒, 月, 日, 年)
$ts = mktime(14, 30, 0, 1, 15, 2024); // 2024-01-15 14:30:00
echo date("h:i A l F dS, Y", $ts); // 02:30 PM Monday January 15th, 2024
// 自動溢出修正
echo date("Y-m-d", mktime(0, 0, 0, 13, 1, 2024)); // 2025-01-01 (13月→次年1月)
?>
6. microtime() - 微秒級計時
<?php
echo microtime(true); // 1705312245.1234 (浮點數秒數,高精度)
echo microtime(); // "0.12345600 1705312245" (字符串: 微秒 秒)
// 性能計時
$start = microtime(true);
// ... 代碼執行 ...
$end = microtime(true);
echo "耗時: " . ($end - $start) . " 秒";
?>
GMT/UTC 時間函數族
| 函數 | 說明 | 等價於 |
| gmdate() | 格式化 GMT/UTC 時間 | date() + 時區=UTC |
| gmmktime() | 獲取 GMT 時間戳 | mktime() + 時區=UTC |
| gmstrftime() | 區域化格式化 GMT 時間 | strftime() + 時區=UTC |
完整格式化字符速查表
| 字符 | 含義 | 範例 |
| Y | 4位年份 | 2024 |
| y | 2位年份 | 24 |
| m | 月份(補零) | 01-12 |
| n | 月份(不補零) | 1-12 |
| F | 月份全稱 | January |
| M | 月份縮寫 | Jan |
| d | 日期(補零) | 01-31 |
| j | 日期(不補零) | 1-31 |
| H | 24制小時(補零) | 00-23 |
| G | 24制小時(不補零) | 0-23 |
| h | 12制小時(補零) | 01-12 |
| g | 12制小時(不補零) | 1-12 |
| i | 分鐘(補零) | 00-59 |
| s | 秒(補零) | 00-59 |
| a/A | am/pm 或 AM/PM | am/PM |
| l | 星期全稱 | Monday |
| D | 星期縮寫 | Mon |
| w | 星期數(0=日) | 0-6 |
| N | ISO星期(1=一) | 1-7 |
| z | 年間第幾天 | 0-365 |
| W | 年間第幾周 | 01-53 |
| t | 當月天數 | 28-31 |
| U | Unix時間戳 | 1705312245 |
| c | ISO8601 | 2024-01-15T14:30:45+08:00 |
| r | RFC2822 | Mon, 15 Jan 2024 14:30:45 +0800 |
現代化開發:DateTime 類 (PHP 5.3+)
<?php
// 創建
$dt = new DateTime('2024-01-15 14:30:00', new DateTimeZone('Asia/Shanghai'));
$dt = new DateTime('@1705312245'); // 從時間戳
$dt = DateTime::createFromFormat('Y-m-d', '2024-01-15');
// 格式化
echo $dt->format('Y-m-d H:i:s');
// 修改
$dt->modify('+1 week');
$dt->add(new DateInterval('P1M'));
$dt->sub(new DateInterval('P3D'));
// 時區轉換 (核心優勢)
$dt->setTimezone(new DateTimeZone('America/New_York'));
// 比較
$dt1 = new DateTime('2024-01-15');
$dt2 = new DateTime('2024-12-31');
var_dump($dt1 < $dt2); // true
// 差值
$diff = $dt1->diff($dt2);
echo $diff->format('%a 天 %h 小時 %i 分鐘'); // 350 天 0 小時 0 分鐘
// 不可變版本 (PHP 5.5+)
$dtImmutable = new DateTimeImmutable('2024-01-15');
$newDt = $dtImmutable->modify('+1 day'); // 返回新對象,原對象不變
?>
時區最佳實踐
- 應用層統一 UTC:
date_default_timezone_set('UTC') 或 php.ini
- 數據庫存儲 UTC:TIMESTAMP 類型自動轉換,DATETIME 需應用層保證
- 展示層轉換用戶時區:前端傳遞 IANA 時區標識 (如 Asia/Shanghai)
- 避免字符串拼接時區:使用 DateTimeZone 對象