計算兩個日期時間之間的差值 (天數、小時、分鐘、秒數) 是常見需求。本文整理從傳統時間戳運算到現代 DateTime/DateInterval 物件導向寫法,以及資料庫層面的計算函數。
<?php
$start = mktime(0, 0, 0, 5, 3, 1998); // 1998-05-03 00:00:00
$end = mktime(0, 0, 0, 6, 5, 1999); // 1999-06-05 00:00:00
$diffSeconds = $end - $start; // 秒數差
$diffDays = (int)round($diffSeconds / 86400); // 86400 = 24*3600
echo "相差 $diffDays 天\n"; // 398 天 (視夏令時間可能 ±1)
/* 注意:
- mktime 參數順序:時、分、秒、月、日、年
- 夏令時間切換日會導致 23/25 小時,round() 可緩解
- 32 位元系統 2038 年後時間戳溢位
*/
?>
<?php
$dt1 = new DateTime('1998-05-03', new DateTimeZone('Asia/Taipei'));
$dt2 = new DateTime('1999-06-05', new DateTimeZone('Asia/Taipei'));
// 1. 取得 DateInterval 物件
$interval = $dt1->diff($dt2); // $dt2 - $dt1
// 2. 直接讀取屬性
echo "相差 {$interval->y} 年 {$interval->m} 月 {$interval->d} 天\n";
echo "總天數:{$interval->days}\n"; // 精確總天數 (不受夏令時間影響)
echo "總小時:{$interval->h + $interval->days*24}\n";
echo "反向?" . ($interval->invert ? '是' : '否') . "\n"; // invert=1 表示 dt1 > dt2
// 3. 格式化輸出
echo $interval->format('%a 天 %h 小時 %i 分鐘 %s 秒'); // %a = 總天數
?>
<?php
$start = strtotime('1998-05-03');
$end = strtotime('1999-06-05');
$days = (int)round(($end - $start) / 86400);
echo "$days 天\n";
// 相對時間字串
echo strtotime('+1 week'); // 一週後
echo strtotime('next Monday'); // 下個週一
echo strtotime('last day of February 2024'); // 2024-02-29
?>
| 資料庫 | 函數/語法 | 範例 |
|---|---|---|
| MySQL / MariaDB | DATEDIFF(end, start)、TIMESTAMPDIFF(unit, start, end) | `SELECT DATEDIFF('1999-06-05', '1998-05-03')` → 398 `SELECT TIMESTAMPDIFF(DAY, '1998-05-03', '1999-06-05')` |
| PostgreSQL | age(), 日期減法、EXTRACT | `SELECT '1999-06-05'::date - '1998-05-03'::date` → 398 `SELECT EXTRACT(DAY FROM AGE('1999-06-05', '1998-05-03'))` |
| SQL Server | DATEDIFF(unit, start, end) | `SELECT DATEDIFF(DAY, '1998-05-03', '1999-06-05')` |
| SQLite | julianday() 相減 | `SELECT CAST(julianday('1999-06-05') - julianday('1998-05-03') AS INT)` |
<?php
function countWeekdays(DateTime $start, DateTime $end, array $holidays = []): int {
$count = 0;
$current = clone $start;
$end = clone $end;
$end->setTime(0,0,0); // 正規化到 00:00
$holidaySet = array_flip(array_map(fn($d) => $d->format('Y-m-d'), $holidays));
while ($current <= $end) {
$dow = (int)$current->format('N'); // 1=Mon ... 7=Sun
$dateStr = $current->format('Y-m-d');
if ($dow < 6 && !isset($holidaySet[$dateStr])) {
$count++;
}
$current->modify('+1 day');
}
return $count;
}
$holidays = [new DateTime('2024-01-01'), new DateTime('2024-02-10')]; // 國定假日
echo countWeekdays(new DateTime('2024-01-01'), new DateTime('2024-01-31'), $holidays); // 21 工作日
?>
DateTimeImmutable + diff(),清晰、正確、可測試。