萬盛學電腦網

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

PHP 日期時間函數完全速查表:date、DateTime、時間戳轉換與時區處理

傳統 date() 格式字元速查

字元意義範例
Y4 位數年2024
y2 位數年24
m月份 01-1205
n月份 1-125
d日期 01-3120
j日期 1-3120
H24 小時 00-2314
h12 小時 01-1202
i分鐘 00-5930
s秒數 00-5905
u微秒 (PHP 5.2.2+)123456
w星期 0(日)-6(六)1
D星期縮寫Mon
l星期全名Monday
W年度第幾週21
t當月天數31
z年度第幾天 0-365140
UUnix 時間戳1716187805
cISO 86012024-05-20T14:30:05+08:00
rRFC 2822Mon, 20 May 2024 14:30:05 +0800

DateTime 物件導向用法(推薦)

$dt = new DateTimeImmutable('now', new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s');        // 2024-05-20 14:30:05
echo $dt->format('c');                  // ISO 8601
echo $dt->getTimestamp();               // Unix timestamp

// 日期運算
$tomorrow = $dt->add(new DateInterval('P1D'));
$lastMonth = $dt->sub(new DateInterval('P1M'));
$nextFriday = $dt->modify('next friday');

// 差值
$diff = $dt->diff(new DateTimeImmutable('2024-12-31'));
echo $diff->format('%a 天 %h 小時 %i 分鐘');

常用靜態建構子

  • DateTime::createFromFormat('Y-m-d', '2024-05-20'):指定格式解析
  • DateTimeImmutable::createFromInterface():從任意介面建立
  • date_create_immutable_from_format():程序式對應

時間戳互轉

$ts = time();                          // 當前秒數
$ts = microtime(true);                 // 含微秒浮點數
$dt = DateTimeImmutable::createFromFormat('U.u', sprintf('%.6f', $ts)); // 微秒還原

時區最佳實務

  1. 腳本開頭 date_default_timezone_set('Asia/Taipei');
  2. 資料庫儲存 **UTC**(TIMESTAMP 或 DATETIME + 應用層統一 UTC)。
  3. 顯示時依用戶偏好時區轉換($dt->setTimezone($userTz))。
  4. 不要靠伺服器系統時區,容器化部署時區常為 UTC。

PHP 8.1+ 新功能

  • DateTimeInterface::format() 支援 !v (毫秒)、!u (微秒) 格式字元。
  • DateTimeZone::getTransitions() 取得時區轉換歷史。
  • date_parse() 回傳結構化陣列,替代 strptime()。
copyright © 萬盛學電腦網 all rights reserved