萬盛學電腦網

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

PHP date() 函數完全指南:格式化 UNIX 時間戳為本地時間字串

函數簡介

date() 是 PHP 最常用的日期時間格式化函數,將 UNIX 時間戳(或當前時間)按指定格式轉換為**本地時區**的字串。配合 `date_default_timezone_set()` 可輸出任意時區時間。

語法與參數

date(string $format, ?int $timestamp = null): string
  • $format:格式字串,由格式字元組成(完整列表)
  • $timestamp:可選 UNIX 時間戳,預設 time()
  • 返回:格式化後的字串,失敗返回 false 並觸發 E_WARNING

常用格式字元分類速查

類別字元說明範例
年Y4位數年份2024
y2位數年份24
L是否閏年 (1/0)1
oISO-8601 週數年份2024
WISO-8601 週數 (01-53)03
月m月份數字 (01-12)01
n月份數字無前導零 (1-12)1
F月份完整英文名January
M月份縮寫 (3字母)Jan
日d日期 (01-31)15
j日期無前導零 (1-31)15
z年間第幾天 (0-365)14
S英文序數後綴 (st,nd,rd,th)th
t當月總天數 (28-31)31
時間H24制小時 (00-23)14
h12制小時 (01-12)02
i分鐘 (00-59)30
s秒 (00-59)59
時區e時區標識符Asia/Shanghai
O偏移量 (+HHMM)+0800
T時區縮寫CST
完整格式cISO 8601 (ATOM)2024-01-15T14:30:59+08:00
完整格式rRFC 2822Mon, 15 Jan 2024 14:30:59 +0800
完整格式UUNIX 時間戳1705330259

代碼範例

<?php
// 設置本地時區(影響 date() 輸出)
date_default_timezone_set('Asia/Shanghai');

$ts = time(); // 當前時間戳

echo "=== date() 格式化示例 (本地時間 Asia/Shanghai) ===\n";
echo "載入頁面時刻: " . date('r') . "\n";                    // RFC 2822
echo "完整日期 (F j, Y): " . date('F j, Y') . "\n";          // January 15, 2024
echo "縮寫日期 (M j, Y): " . date('M j, Y') . "\n";          // Jan 15, 2024
echo "數字日期 (m/d/y): " . date('m/d/y') . "\n";            // 01/15/24
echo "序數日期 (jS of M, Y): " . date('jS of M, Y') . "\n";  // 15th of Jan, 2024
echo "12制時間 (g:i:s A T): " . date('g:i:s A T') . "\n";    // 2:30:59 PM CST
echo "24制時間 (H:i:s O): " . date('H:i:s O') . "\n";        // 14:30:59 +0800

// 年份與閏年
echo "\n年份: " . date('Y') . "\n";
echo date('L') ? "是閏年\n" : "非閏年\n";

// 紀元至今秒數
echo "\n自 1970-01-01 秒數: " . time() . "\n";

// 指定時間戳
$fixed = strtotime('2024-12-25 00:00:00');
echo "\n聖誕節: " . date('Y-m-d (l)', $fixed) . "\n"; // 2024-12-25 (Wednesday)
?>

輸出結果示例

=== date() 格式化示例 (本地時間 Asia/Shanghai) ===
載入頁面時刻: Mon, 15 Jan 2024 22:30:59 +0800
完整日期 (F j, Y): January 15, 2024
縮寫日期 (M j, Y): Jan 15, 2024
數字日期 (m/d/y): 01/15/24
序數日期 (jS of M, Y): 15th of Jan, 2024
12制時間 (g:i:s A T): 10:30:59 PM CST
24制時間 (H:i:s O): 22:30:59 +0800

年份: 2024
是閏年

自 1970-01-01 秒數: 1705330259

聖誕節: 2024-12-25 (Wednesday)

date() vs gmdate() 關鍵差異

<?php
date_default_timezone_set('America/New_York'); // UTC-5 (冬令時)

$ts = strtotime('2024-01-15 12:00:00'); // 假設此為 UTC 時間

echo "date()   (本地 EST): " . date('Y-m-d H:i:s T', $ts) . "\n";  // 2024-01-15 07:00:00 EST
echo "gmdate() (UTC/GMT):  " . gmdate('Y-m-d H:i:s T', $ts) . "\n"; // 2024-01-15 12:00:00 GMT

// 同一時間戳,輸出相差 5 小時(時區偏移)
?>

實戰最佳實踐

1. 統一使用 ISO 8601 格式 (c) 進行數據交換

// API 回應、資料庫存儲、日誌記錄
$iso8601 = date('c'); // 2024-01-15T22:30:59+08:00
$iso8601_utc = gmdate('c'); // 2024-01-15T14:30:59+00:00

2. 用戶顯示根據偏好時區格式化

function formatForUser(int $timestamp, string $userTimezone, string $format = 'Y-m-d H:i'): string {
    $dt = new DateTime('@' . $timestamp);
    $dt->setTimezone(new DateTimeZone($userTimezone));
    return $dt->format($format);
}

echo formatForUser(time(), 'America/Los_Angeles'); // 2024-01-15 06:30
echo formatForUser(time(), 'Europe/London');       // 2024-01-15 14:30
?>

3. 避免常見陷阱

  • 時區未設置:PHP 5.4+ 會發出 E_WARNING 並預設 UTC。務必在入口文件設置 `date_default_timezone_set('Asia/Shanghai')`。
  • 格式字元大小寫敏感:`m`(月) vs `M`(月縮寫),`h`(12制) vs `H`(24制)。
  • 時間戳範圍:32 位系統限於 1901-2038 年(2038 年問題)。64 位系統無此限制。跨平台專案建議使用 DateTime。
  • 微秒支援:`date()` 不支援微秒。需微秒用 DateTime::format('u') 或 microtime() 組合。

DateTime 物件導向替代(推薦新專案)

<?php
$dt = new DateTime('now', new DateTimeZone('Asia/Shanghai'));
// 或從時間戳
$dt = DateTime::createFromFormat('U', (string)time());
$dt->setTimezone(new DateTimeZone('Asia/Shanghai'));

echo $dt->format('Y-m-d H:i:s'); // 同 date()
echo $dt->format('c');           // ISO 8601

// 日期運算
$dt->modify('+1 week');
$dt->add(new DateInterval('P1M'));
$diff = $dt->diff(new DateTime('now'));
?>

總結

date() 是 PHP 日期格式化的基石函數,掌握其豐富的格式字元、時區行為、與 gmdate() 的區別至關重要。現代 PHP 開發(7.1+)強烈建議遷移至 DateTimeImmutable 類別,獲得更好的型別安全、不可變性、時區處理、日期運算與格式化能力。但理解 date() 仍是閱讀舊代碼、編寫簡單腳本、快速原型的必備基礎。

copyright © 萬盛學電腦網 all rights reserved