計算「距離某月某日還有多少天」是生日提醒、節日倒計時、訂單截止提醒的常見需求。本文提供一個健壯的 countDaysUntil() 函數,自動處理跨年邏輯(若今年已過則計算明年),並給出 Carbon 庫的一行代碼替代方案。
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 計算?需業務定義)
$from。DateTimeImmutable::createFromFormat 安全解析,失敗拋異常。$targetThisYear <= $from 表示「今天已過或就是今天」,自動推遲到明年同一天。DateTime::diff() 返回 DateInterval,%a 格式輸出總天數(含年月換算),比手工除以 86400 更精確(自動處理夏令時、閏年)。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_date | 30/15/7/3/1 天多級告警,郵件+鉚釘/企微機器人通知 |
$from 必須統一為同一時區(建議 UTC 計算,展示時轉換)。createFromFormat 會自動轉為 3 月 1 日,需根據業務覆蓋。$target <= $from 判定「今天算已過」,若需「今天還剩 0 天」改為 $target < $from。日期計算看似簡單,實則暗藏時區、閏年、夏令時、曆法切換等陷阱。原生 DateTime 已足夠健壯,複雜業務請直接引入 Carbon 享受成熟生態。