萬盛學電腦網

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

PHP 計算距離指定日期剩餘天數:支援跨年、生日倒計時、節日提醒場景

計算「距離某月某日還有多少天」是生日提醒、節日倒計時、訂單截止提醒的常見需求。本文提供一個健壯的 countDaysUntil() 函數,自動處理跨年邏輯(若今年已過則計算明年),並給出 Carbon 庫的一行代碼替代方案。

原生 PHP 實現

function countDaysUntil(string $monthDay, DateTimeInterface $from = null): int {
    // $monthDay 格式:"MM-DD" 或 "M-D",如 "05-20"、"12-31"
    $from = $from ?? new DateTimeImmutable();
    $year = (int)$from->format('Y');
    $targetThisYear = DateTimeImmutable::createFromFormat('Y-m-d', "$year-$monthDay");
    if (!$targetThisYear) throw new InvalidArgumentException("無效日期格式: $monthDay");

    // 若目標日期已過(含今天),計算明年
    if ($targetThisYear <= $from) {
        $targetThisYear = $targetThisYear->modify('+1 year');
    }
    $interval = $from->diff($targetThisYear);
    return (int)$interval->format('%a'); // 總天數差
}

// 使用
echo countDaysUntil('05-20');           // 距離今年/明年 5 月 20 日天數
echo countDaysUntil('12-31', new DateTime('2024-12-30')); // 1 天
echo countDaysUntil('02-29');           // 閏年自動處理(非閏年按 3 月 1 計算?需業務定義)

關鍵邏輯解析

  1. 解析輸入:只接收月日,年份動態取自基準時間 $from。
  2. 構造今年目標:DateTimeImmutable::createFromFormat 安全解析,失敗拋異常。
  3. 跨年判斷:$targetThisYear <= $from 表示「今天已過或就是今天」,自動推遲到明年同一天。
  4. 差值計算:DateTime::diff() 返回 DateInterval,%a 格式輸出總天數(含年月換算),比手工除以 86400 更精確(自動處理夏令時、閏年)。

Carbon 一行代碼實現

use Carbon\Carbon;

function daysUntilCarbon(string $monthDay, Carbon $from = null): int {
    $from = $from ?? Carbon::now();
    $target = Carbon::createFromFormat('m-d', $monthDay)->year($from->year);
    if ($target->lte($from)) $target->addYear();
    return (int)$from->diffInDays($target, false); // false = 不取絕對值,未來為正
}

// 支援鏈式調用
echo Carbon::parse('05-20')->diffForHumans(['parts' => 1]); // "5 個月後" (視當前日期)

應用場景擴展

場景輸入來源業務邏輯
用戶生日提醒用戶表 birthday (DATE)每日定時任務掃描 7 天內生日,推送站內信/郵件/短信
訂單付款倒計時訂單 expire_at (DATETIME)前端 JS 實時倒計時,後端輪詢關閉超時訂單
節日營銷活動固定日期(雙十一 11-11、雙十二 12-12)活動頁顯示「距離雙十一還有 45 天」,自動切換主題
證書/域名到期預警資產表 expire_date30/15/7/3/1 天多級告警,郵件+鉚釘/企微機器人通知

常見坑點

  • 時區不一致:數據庫存儲 UTC,應用層用戶時區不同,$from 必須統一為同一時區(建議 UTC 計算,展示時轉換)。
  • 閏年 2 月 29 日:非閏年如何處理?業務常見策略:提前到 2 月 28 日、延後到 3 月 1 日、或僅在閏年提醒。代碼中 createFromFormat 會自動轉為 3 月 1 日,需根據業務覆蓋。
  • 包含今天還是不含:$target <= $from 判定「今天算已過」,若需「今天還剩 0 天」改為 $target < $from。

日期計算看似簡單,實則暗藏時區、閏年、夏令時、曆法切換等陷阱。原生 DateTime 已足夠健壯,複雜業務請直接引入 Carbon 享受成熟生態。

copyright © 萬盛學電腦網 all rights reserved