PHP 日期計算陷阱：為什么 "2025-05-31 -1 months" 會變成 2025-05-01？

在 PHP 開發中，日期計算是一個常見的需求，但 PHP 的 strtotime() 函數在處理月份加減時有一些反直覺的行為，如果不了解這些特性，可能會導致難以察覺的 bug。本文將深入探討這些行為，并通過實際例子展示如何正確計算日期。

1、問題

$date = date('Y-m-d', strtotime("2025-05-31 -1 months"));
// 輸出：2025-05-01，而不是預期的2025-04-30

2、原因解析

PHP 的日期計算遵循以下規則：

1. 當從某個月的最后一天減去月份時，如果目標月份的天數不足，PHP 不會簡單地返回目標月份的最后一天
2. 而是會嘗試"保持日期"，即31號減去1個月會嘗試返回30號（如果存在），否則會溢出到下個月

2025年4月只有30天，沒有31號，所以：

• 2025-05-31 -1 month = 2025-04-31 → 這個日期不存在
• PHP 的處理方式是：31 - 30 = 1 → 2025-05-01

3、例子

// 例子1
$date = date('Y-m-d', strtotime("2025-05-31 -3 months"));
// 輸出：2025-03-03，而不是2025-02-28
// 因為：5月31日→2月31日不存在→31-28=3→3月3日

// 例子2
$date = date('Y-m-01', strtotime("2025-05-31 -3 months"));
// 輸出：2025-03-01
// 強制使用01日后，結果變為3月1日

4、解決方法

方法1：使用月份的第一天

// 先轉到月份的第一天，再進行計算
$date = date('Y-m-d', strtotime("first day of 2025-05-31 -3 months"));
// 輸出：2025-02-01

方法2：使用 DateTime 類（更可靠）

$date = new DateTime("2025-05-31");
$date->modify("-3 months");
// 輸出：2025-03-03（同樣的問題）

// 更好的方式：
$date = new DateTime("first day of 2025-05-31");
$date->modify("-3 months");
// 輸出：2025-02-01

**方法3：獲取上個月的最后一天 **

$date = new DateTime("2025-05-31");
$date->modify("last day of previous month");
// 輸出：2025-04-30

5、建議

1. 避免在月末日期上直接加減月份 - 這會導致不可預測的結果
2. 明確你的業務需求：
   • 如果你想要"上個月的同一天"（如果存在）
   • 或者"上個月的最后一天"
   • 或者"上個月的第一天"
3. 使用 DateTime 類代替 strtotime - 它提供了更清晰的API和更好的可讀性
4. 始終測試邊界情況 - 特別是1月、2月、7月、8月、12月等月份