萬盛學電腦網

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

PHP 計算兩日期相差天數:從手動演算法到 DateTime 現代寫法

需求:計算從 2000-01-01 起至指定日期的天數(含首尾)

早期 PHP 版本缺乏強大的日期時間物件,開發者常自行撰寫演算法處理閏年、大小月。現代 PHP(5.3+)內建 DateTime、DateInterval,只需幾行程式碼即可精確計算。

現代標準寫法(推薦)

<?php
function daysFrom2000(string $endDate, string $startDate = '2000-01-01'): int
{
    $start = new DateTime($startDate);
    $end   = new DateTime($endDate);

    // 含首尾:差值 + 1
    $diff = $start->diff($end);
    return $diff->days + 1;
}

// 測試
echo daysFrom2000('2000-01-01'); // 1
echo daysFrom2000('2000-01-02'); // 2
echo daysFrom2000('2000-12-31'); // 366 (2000 是閏年)
echo daysFrom2000('2024-05-20'); // 8900+

優點

  • 自動處理閏年、月份天數、時區
  • 程式碼簡潔、可讀、可維護
  • 支援 PHP 5.3+ 所有版本

手動演算法解析(教學參考)

原始碼展示的邏輯:

  1. 移除日期字串中的連字號 YYYYMMDD
  2. 判斷同年、同月、跨月、跨年
  3. 閏年判斷:year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0)
  4. 累加每月天數至目標月,再加上日數
<?php
// 手動演算法完整版(含首尾)
function calStart2EndManual(string $endDay, string $startDay = '2000-01-01'): int
{
    $start = str_replace('-', '', $startDay);
    $end   = str_replace('-', '', $endDay);

    if ($end < $start) return 0;

    $sy = (int)substr($start, 0, 4);
    $ey = (int)substr($end, 0, 4);
    $sm = (int)substr($start, 4, 2);
    $em = (int)substr($end, 4, 2);
    $sd = (int)substr($start, 6, 2);
    $ed = (int)substr($end, 6, 2);

    $monthDays = [1=>31, 2=>28, 3=>31, 4=>30, 5=>31, 6=>30, 7=>31, 8=>31, 9=>30, 10=>31, 11=>30, 12=>31];

    $total = 0;

    // 同年
    if ($sy === $ey) {
        $leap = ($sy % 4 === 0 && ($sy % 100 !== 0 || $sy % 400 === 0));
        $monthDays[2] = $leap ? 29 : 28;

        if ($sm === $em) {
            return $ed - $sd + 1;
        }

        // 起始月剩餘天數
        $total += $monthDays[$sm] - $sd + 1;
        // 中間完整月份
        for ($m = $sm + 1; $m < $em; $m++) {
            $total += $monthDays[$m];
        }
        // 結束月天數
        $total += $ed;
        return $total;
    }

    // 跨年:起始年剩餘天數
    $leap = ($sy % 4 === 0 && ($sy % 100 !== 0 || $sy % 400 === 0));
    $monthDays[2] = $leap ? 29 : 28;
    for ($m = $sm; $m <= 12; $m++) {
        $total += ($m === $sm) ? ($monthDays[$m] - $sd + 1) : $monthDays[$m];
    }

    // 中間完整年份
    for ($y = $sy + 1; $y < $ey; $y++) {
        $total += ($y % 4 === 0 && ($y % 100 !== 0 || $y % 400 === 0)) ? 366 : 365;
    }

    // 結束年
    $leap = ($ey % 4 === 0 && ($ey % 100 !== 0 || $ey % 400 === 0));
    $monthDays[2] = $leap ? 29 : 28;
    for ($m = 1; $m <= $em; $m++) {
        $total += ($m === $em) ? $ed : $monthDays[$m];
    }

    return $total;
}

效能與正確性比較

項目DateTime::diff手動演算法
程式碼行數~5 行~60 行
閏年處理內建正確需自行實作
時區支援內建無
執行速度極快(C 實作)較慢(PHP 迴圈)
適用場景所有現代專案教學、極舊環境(PHP < 5.3)

常見陷阱與最佳實踐

  • 時區一致性:date_default_timezone_set('Asia/Taipei') 確保伺服器與應用時區一致。
  • 含首尾邏輯:diff()->days 回傳「不含首日」的差值,需 +1。
  • 日期格式驗證:輸入前用 DateTime::createFromFormat('Y-m-d', $str) 驗證合法性。
  • 大量計算優化:批次處理時,重複使用 DateTime 物件或改用 Unix timestamp 運算。

結語

除非身處無法升級的古老環境,否則請毫猶豫使用 DateTime 系列類別。它們解決了日期時間運算中所有棘手的邊界條件,讓你專注於業務邏輯而非曆法細節。

copyright © 萬盛學電腦網 all rights reserved