date() 是 PHP 格式化日期時間最常用的函數。本文提供完整格式字元參考表、常用組合範例、時區處理、以及現代 DateTime 物件導向用法。
date(string $format, ?int $timestamp = null): string
$format:格式字串$timestamp:Unix 時間戳,預設為 time()(當前時間)| 字元 | 說明 | 範例輸出 |
|---|---|---|
| 年份 | ||
Y | 4 位數年份 | 2024 |
y | 2 位數年份 | 24 |
| 月份 | ||
m | 數字月份,前導零 | 01 - 12 |
n | 數字月份,無前導零 | 1 - 12 |
F | 英文完整月份名 | January |
M | 英文縮寫月份 | Jan |
| 日期 | ||
d | 月份中的第幾天,前導零 | 01 - 31 |
j | 月份中的第幾天,無前導零 | 1 - 31 |
z | 年份中的第幾天 | 0 - 365 |
| 星期 | ||
l | 星期完整名稱 | Sunday |
D | 星期縮寫 | Sun |
w | 星期數字 | 0 (Sun) - 6 (Sat) |
N | ISO-8601 星期數字 | 1 (Mon) - 7 (Sun) |
| 時間 (24小時制) | ||
H | 時,前導零 | 00 - 23 |
G | 時,無前導零 | 0 - 23 |
| 時間 (12小時制) | ||
h | 時,前導零 | 01 - 12 |
g | 時,無前導零 | 1 - 12 |
a | am/pm 小寫 | am / pm |
A | AM/PM 大寫 | AM / PM |
| 分秒 | ||
i | 分,前導零 | 00 - 59 |
s | 秒,前導零 | 00 - 59 |
u | 微秒 (PHP 5.2.2+) | 654321 |
| 時區 | ||
e | 時區識別碼 | UTC, Asia/Taipei |
O | 與 GMT 時差 | +0800 |
P | 與 GMT 時差 (含冒號) | +08:00 |
T | 時區縮寫 | CST |
| 完整格式 | ||
c | ISO 8601 | 2024-01-15T14:30:00+08:00 |
r | RFC 2822 | Mon, 15 Jan 2024 14:30:00 +0800 |
U | Unix 時間戳 | 1705309800 |
<?php
// 當前時間
echo date('Y-m-d H:i:s'); // 2024-01-15 14:30:00
echo date('Y/m/d'); // 2024/01/15
echo date('Y年m月d日'); // 2024年01月15日
// 含星期
echo date('Y-m-d (D)'); // 2024-01-15 (Mon)
echo date('Y-m-d l'); // 2024-01-15 Monday
// 12小時制
echo date('Y-m-d h:i:s A'); // 2024-01-15 02:30:00 PM
// ISO 8601 / RFC 3339 (API、資料交換標準)
echo date('c'); // 2024-01-15T14:30:00+08:00
echo date(DateTime::RFC3339); // 同上
// 自訂格式
echo date('m-d H:i'); // 01-15 14:30
echo date('dmY'); // 15012024
<?php
// 方法一:php.ini 設定(全域)
date.timezone = "Asia/Taipei"
// 方法二:程式碼設定(每支腳本開頭)
date_default_timezone_set('Asia/Taipei');
// 方法三:DateTime 物件指定時區
$dt = new DateTime('now', new DateTimeZone('Asia/Taipei'));
echo $dt->format('Y-m-d H:i:s');
常見時區識別碼: Asia/Taipei、Asia/Shanghai、Asia/Hong_Kong、UTC、America/New_York
DateTime 提供物件導向介面、不可變體 DateTimeImmutable、支援運算、比較、差值計算,功能更強大。
<?php
// 建立
$now = new DateTime(); // 當前時間,預設時區
$dt = new DateTime('2024-01-15 14:30:00', new DateTimeZone('Asia/Taipei'));
$dt2 = DateTime::createFromFormat('Y-m-d', '2024-01-15');
// 格式化
echo $dt->format('Y-m-d H:i:s');
// 日期運算
$dt->modify('+1 day'); // 修改原物件
$dt->add(new DateInterval('P1M')); // 加 1 月
$dt->sub(new DateInterval('P7D')); // 減 7 天
// 不可變體 (PHP 5.5+) - 推薦用於避免副作用
$immutable = new DateTimeImmutable('2024-01-15');
$nextWeek = $immutable->add(new DateInterval('P1W')); // 回傳新物件,原物件不變
// 差值計算
$start = new DateTime('2024-01-01');
$end = new DateTime('2024-01-15');
$diff = $start->diff($end);
echo $diff->days; // 14
echo $diff->format('%a 天 %h 小時 %i 分鐘');
// 比較
$dt1 = new DateTime('2024-01-15');
$dt2 = new DateTime('2024-01-20');
var_dump($dt1 < $dt2); // true
// 時間戳互轉
$timestamp = $dt->getTimestamp(); // 取得 Unix timestamp
$dt = (new DateTime())->setTimestamp($timestamp); // 從 timestamp 建立
| 問題 | 原因 | 解決 |
|---|---|---|
| 時間差 8 小時 | 未設定時區,預設 UTC | date_default_timezone_set('Asia/Taipei') |
| 月份 02-30 不報錯 | date() 不驗證日期有效性 | 用 DateTime::createFromFormat() 驗證 |
| strtotime() 解析歧義 | '01/02/2024' 美式/歐式格式衝突 | 用 DateTime::createFromFormat() 指定格式 |
| 微秒一直是 000000 | date() 不支援微秒 | 用 DateTime::format('u') 或 microtime(true) |
| 32 位元系統 2038 年問題 | Unix timestamp 溢位 | 用 64 位元 PHP + DateTime |
<?php
// 友善相對時間:剛剛、5分鐘前、3小時前、昨天、3天前、2024-01-15
function timeAgo(DateTimeInterface $time): string {
$now = new DateTime();
$diff = $now->getTimestamp() - $time->getTimestamp();
if ($diff < 60) return '剛剛';
if ($diff < 3600) return floor($diff/60) . ' 分鐘前';
if ($diff < 86400) return floor($diff/3600) . ' 小時前';
if ($diff < 172800) return '昨天';
if ($diff < 604800) return floor($diff/86400) . ' 天前';
return $time->format('Y-m-d');
}
// 取得本月第一天/最後一天
function getMonthRange(int $year, int $month): array {
$first = new DateTime("{$year}-{$month}-01");
$last = clone $first;
$last->modify('last day of this month');
return [$first, $last];
}
掌握 date() 格式字元與 DateTime 物件,能靈活處理各種日期時間需求。