萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 計算時間差的多種方法:時間戳、DateTime、資料庫函數

PHP 計算時間差的多種方法:時間戳、DateTime、資料庫函數

計算兩個日期時間之間的差值 (天數、小時、分鐘、秒數) 是常見需求。本文整理從傳統時間戳運算到現代 DateTime/DateInterval 物件導向寫法,以及資料庫層面的計算函數。

方法一:Unix 時間戳相減 (傳統、直觀)

<?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 年後時間戳溢位
*/
?>

方法二:DateTime + DateInterval (現代、精確、支援時區、微秒)

<?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 = 總天數
?>

方法三:strtotime 解析字串 (快速原型)

<?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 / MariaDBDATEDIFF(end, start)、TIMESTAMPDIFF(unit, start, end)`SELECT DATEDIFF('1999-06-05', '1998-05-03')` → 398
`SELECT TIMESTAMPDIFF(DAY, '1998-05-03', '1999-06-05')`
PostgreSQLage(), 日期減法、EXTRACT`SELECT '1999-06-05'::date - '1998-05-03'::date` → 398
`SELECT EXTRACT(DAY FROM AGE('1999-06-05', '1998-05-03'))`
SQL ServerDATEDIFF(unit, start, end)`SELECT DATEDIFF(DAY, '1998-05-03', '1999-06-05')`
SQLitejulianday() 相減`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 工作日
?>

常見陷阱與最佳實踐

  1. 時區一致性:兩個 DateTime 必須相同時區,或先 `setTimezone()` 統一。
  2. 夏令時間:`diff()->days` 給出真實日曆天數,不受 DST 影響;手算秒數/86400 會在 DST 切換日出現 23/25 小時誤差。
  3. 微秒精度:`DateTime` 支援微秒 (`u` 格式),`diff()` 保留微秒差 (`$interval->f`)。
  4. 不可變版本:PHP 7.1+ 提供 `DateTimeImmutable`,所有修改方法回傳新實例,避免副作用。
  5. 資料庫時區:確保 DB 連線時區 (`SET time_zone = '+08:00'`) 與 PHP 一致,否則 `NOW()`、`CURRENT_TIMESTAMP` 會有偏差。

總結建議

  • 新專案:全面使用 DateTimeImmutable + diff(),清晰、正確、可測試。
  • 大量資料統計:下推到資料庫用 `DATEDIFF`/`TIMESTAMPDIFF`,只回傳結果。
  • 簡單腳本/相容舊代碼:`strtotime` + 時間戳相減可接受,但需註解說明夏令時間風險。
  • 避免:手寫日期運算邏輯 (閏年、大小月、DST 極易出錯)。
copyright © 萬盛學電腦網 all rights reserved