PHP Date/Time 函數完整指南：日期時間處理大全

簡介

Date/Time 函數讓您從伺服器取得日期時間，並以多種格式輸出。注意：這些函數依賴伺服器的本地設定，使用時請考量夏令時間與閏年。PHP 5.2 起引入 DateTime 物件導向介面，功能更強大。

執行期設定 (php.ini)

建議：在 php.ini 或腳本開頭設定 date_default_timezone_set('Asia/Taipei') 避免警告。

程序式核心函數速查

物件導向 DateTime 類別核心方法

DateInterval 與 DatePeriod

• date_interval_create_from_date_string() — 從字串建立間隔 (如 2 days)
• date_interval_format() — 格式化間隔輸出
• new DatePeriod($start, $interval, $recurrences) — 產生週期性日期序列

常用格式化字元 (date() / DateTime::format())

預定義日期常數

• DATE_ATOM — Atom (2005-08-15T16:13:03+0000)
• DATE_COOKIE — HTTP Cookie (Sun, 14 Aug 2005 16:13:03 UTC)
• DATE_ISO8601 — ISO-8601
• DATE_RFC822 / DATE_RFC850 / DATE_RFC1036 / DATE_RFC1123 / DATE_RFC2822
• DATE_RSS — RSS
• DATE_W3C — W3C

實用範例

1. 設定時區並輸出當前時間

<?php
date_default_timezone_set('Asia/Taipei');
echo date('Y-m-d H:i:s') . '<br>'; // 2024-01-15 10:30:00
?>

2. 計算兩日期差距

<?php
$start = new DateTime('2024-01-01');
$end = new DateTime('2024-01-15');
$diff = $start->diff($end);
echo $diff->format('%a 天 %h 小時 %i 分鐘'); // 14 天 0 小時 0 分鐘
?>

3. 解析使用者輸入日期

<?php
$input = '15/01/2024';
$dt = DateTime::createFromFormat('d/m/Y', $input);
if ($dt) {
    echo $dt->format('Y-m-d');
} else {
    echo '格式錯誤';
}
?>

4. 產生未來 5 個週五

<?php
$period = new DatePeriod(
    new DateTime('next friday'),
    new DateInterval('P1W'),
    5
);
foreach ($period as $dt) {
    echo $dt->format('Y-m-d') . '<br>';
}
?>

關鍵建議

• 新專案優先使用 DateTime 物件導向介面，功能更完整、時區處理更安全。
• 儲存資料庫時統一使用 UTC (DATE_ATOM 或時間戳)，顯示時再轉換使用者時區。
• 避免直接操作時間戳進行日期運算，改用 DateInterval / modify() 避免夏令時間陷阱。