萬盛學電腦網

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

PHP 日期時間函數系統學習:時間戳、時區、格式化與驗證完全指南

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

完整格式化字符速查表

字符含義範例
Y4位年份2024
y2位年份24
m月份(補零)01-12
n月份(不補零)1-12
F月份全稱January
M月份縮寫Jan
d日期(補零)01-31
j日期(不補零)1-31
H24制小時(補零)00-23
G24制小時(不補零)0-23
h12制小時(補零)01-12
g12制小時(不補零)1-12
i分鐘(補零)00-59
s秒(補零)00-59
a/Aam/pm 或 AM/PMam/PM
l星期全稱Monday
D星期縮寫Mon
w星期數(0=日)0-6
NISO星期(1=一)1-7
z年間第幾天0-365
W年間第幾周01-53
t當月天數28-31
UUnix時間戳1705312245
cISO86012024-01-15T14:30:45+08:00
rRFC2822Mon, 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'); // 返回新對象,原對象不變
?>

時區最佳實踐

  1. 應用層統一 UTC:date_default_timezone_set('UTC') 或 php.ini
  2. 數據庫存儲 UTC:TIMESTAMP 類型自動轉換,DATETIME 需應用層保證
  3. 展示層轉換用戶時區:前端傳遞 IANA 時區標識 (如 Asia/Shanghai)
  4. 避免字符串拼接時區:使用 DateTimeZone 對象
copyright © 萬盛學電腦網 all rights reserved