string date ( string $format [, int $timestamp = time() ] )
第二參數為 Unix 時間戳 (預設當前時間)。
| 字元 | 說明 | 範例輸出 |
|---|---|---|
| 年 | ||
| Y | 4 位數年份 | 2024 |
| y | 2 位數年份 | 24 |
| 月 | ||
| m | 數字月份,前導零 | 01-12 |
| n | 數字月份,無前導零 | 1-12 |
| F | 月份完整英文名 | January |
| M | 月份 3 字母縮寫 | Jan |
| 日 | ||
| d | 日期,前導零 | 01-31 |
| j | 日期,無前導零 | 1-31 |
| S | 日期序數後綴 | st, nd, rd, th |
| 時間 (12小時制) | ||
| h | 小時,前導零 | 01-12 |
| g | 小時,無前導零 | 1-12 |
| a | am/pm 小寫 | am |
| A | AM/PM 大寫 | AM |
| 時間 (24小時制) | ||
| H | 小時,前導零 | 00-23 |
| G | 小時,無前導零 | 0-23 |
| i | 分鐘,前導零 | 00-59 |
| s | 秒數,前導零 | 00-59 |
| 星期 | ||
| l | 星期完整名稱 | Monday |
| D | 星期 3 字母縮寫 | Mon |
| w | 星期數字 (0=星期日) | 0-6 |
| W | 年份第幾週 | 01-53 |
| 其他 | ||
| t | 當月總天數 | 28-31 |
| z | 年份第幾天 | 0-365 |
| L | 是否閏年 | 1/0 |
| U | Unix 時間戳 | 1704067200 |
| c | ISO 8601 格式 | 2024-01-01T00:00:00+00:00 |
| r | RFC 2822 格式 | Mon, 01 Jan 2024 00:00:00 +0000 |
<?php
// 日期
echo date('Y-m-d'); // 2024-01-15 (標準)
echo date('Y/n/j'); // 2024/1/15 (無前導零)
echo date('Y年m月d日'); // 2024年01月15日 (中文)
echo date('Y-F-jS'); // 2024-January-15th
// 時間
echo date('H:i:s'); // 14:30:59 (24小時制)
echo date('h:i:s A'); // 02:30:59 PM (12小時制)
// 完整日期時間
echo date('Y-m-d H:i:s'); // 2024-01-15 14:30:59 (資料庫常用)
echo date('c'); // ISO 8601 (API 傳輸標準)
echo date('r'); // RFC 2822 (HTTP 標頭、Email 標準)
?>
預設時區為 UTC,直接使用 date() 會與本地時間相差數小時 (台灣/中國 +8小時)。
<?php
date_default_timezone_set('Asia/Taipei'); // 或 'Asia/Shanghai', 'PRC'
echo date('Y-m-d H:i:s'); // 正確顯示本地時間
?>
; php.ini
date.timezone = "Asia/Taipei"
; 可用值:Asia/Taipei, Asia/Shanghai, Asia/Hong_Kong, PRC, UTC 等
修改後重啟 PHP 服務。
<?php
$tz = new DateTimeZone('Asia/Taipei');
$dt = new DateTime('now', $tz);
echo $dt->format('Y-m-d H:i:s');
// 或修改現有物件時區
$dt = new DateTime('2024-01-01 12:00:00', new DateTimeZone('UTC'));
$dt->setTimezone(new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s'); // 2024-01-01 20:00:00
?>
<?php
// 日期字串 → 時間戳
$ts = strtotime('2024-01-15 14:30:00');
$ts = strtotime('+1 week');
$ts = strtotime('next Monday');
// 時間戳 → 格式化日期
echo date('Y-m-d', $ts);
// DateTime 更強大
$dt = DateTime::createFromFormat('Y/m/d', '2024/01/15');
echo $dt->format('Y-m-d');
?>
| 特性 | date() | DateTime |
|---|---|---|
| 風格 | 程序式 | 物件導向 |
| 時區處理 | 全域設定 | 物件級獨立時區 |
| 運算 | 難 (需 strtotime) | 簡單 modify(), add(), sub(), diff() |
| 不可變版本 | 無 | DateTimeImmutable (PHP 5.5+) |
| 格式化 | format 字串 | format 字串 |
日期時間處理核心在於時區正確性。現代 PHP 專案強烈建議:統一使用 DateTime/DateTimeImmutable,配合 date_default_timezone_set('Asia/Taipei') 全域設定,徹底避開 date() 時區陷阱與 strtotime() 解析歧義。