date() 是 PHP 最常用的日期時間格式化函數,將 UNIX 時間戳(或當前時間)按指定格式轉換為**本地時區**的字串。配合 `date_default_timezone_set()` 可輸出任意時區時間。
date(string $format, ?int $timestamp = null): string
$format:格式字串,由格式字元組成(完整列表)$timestamp:可選 UNIX 時間戳,預設 time()false 並觸發 E_WARNING| 類別 | 字元 | 說明 | 範例 |
|---|---|---|---|
| 年 | Y | 4位數年份 | 2024 |
| y | 2位數年份 | 24 | |
| L | 是否閏年 (1/0) | 1 | |
| o | ISO-8601 週數年份 | 2024 | |
| W | ISO-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 | |
| 時間 | H | 24制小時 (00-23) | 14 |
| h | 12制小時 (01-12) | 02 | |
| i | 分鐘 (00-59) | 30 | |
| s | 秒 (00-59) | 59 | |
| 時區 | e | 時區標識符 | Asia/Shanghai |
| O | 偏移量 (+HHMM) | +0800 | |
| T | 時區縮寫 | CST | |
| 完整格式 | c | ISO 8601 (ATOM) | 2024-01-15T14:30:59+08:00 |
| 完整格式 | r | RFC 2822 | Mon, 15 Jan 2024 14:30:59 +0800 |
| 完整格式 | U | UNIX 時間戳 | 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)
<?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 小時(時區偏移)
?>
// API 回應、資料庫存儲、日誌記錄
$iso8601 = date('c'); // 2024-01-15T22:30:59+08:00
$iso8601_utc = gmdate('c'); // 2024-01-15T14:30:59+00:00
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
?>
E_WARNING 並預設 UTC。務必在入口文件設置 `date_default_timezone_set('Asia/Shanghai')`。DateTime。DateTime::format('u') 或 microtime() 組合。<?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() 仍是閱讀舊代碼、編寫簡單腳本、快速原型的必備基礎。