PHP使用date_diff计算两日期差值不符合预期如何解决

原代码输出结果的原因 #

PHP内置的date_diff函数采用严格周年匹配规则计算时间间隔：只有当对比的第二个日期达到（或超过）第一个日期的同月同日周年节点时，才会累计1个完整年度。
针对你的测试用例，2015-01-01对应的1周年节点是2016-01-01，目标结束日期是2015-12-31，距离该节点差1天，因此函数输出0年11个月29天，是函数设计下的正常表现，不属于代码故障。

适配需求的实现方案 #

你的预期是将同自然年内1月1日到12月31日的完整跨度计为1年，可根据业务场景选择以下实现：

方案1：按自然年度覆盖规则计算 #

• 适用场景：需要统计日期区间内完整覆盖的公历年数量
• 计算逻辑：只要日期区间的范围完整包含某一自然年的1月1日至12月31日，就计为1个完整年度
  代码示例：

$date1 = date_create("2015-01-01");
$date2 = date_create("2015-12-31");
$fullYearCount = 0;
$startYear = (int)$date1->format("Y");
$endYear = (int)$date2->format("Y");
// 遍历日期区间覆盖的所有自然年
for ($y = $startYear; $y <= $endYear; $y++) {
    $yearStart = date_create("$y-01-01");
    $yearEnd = date_create("$y-12-31");
    // 判断当前自然年是否被日期区间完整覆盖
    if ($date1 <= $yearStart && $date2 >= $yearEnd) {
        $fullYearCount++;
    }
}
echo "{$fullYearCount}年";

运行该代码对2015-01-01到2015-12-31的区间计算，将得到1年的预期结果。

方案2：按自然月终点累加计算 #

• 适用场景：需要按月度周期累计时长、不强制严格匹配同月同日周年节点的场景，比如服务时长、工龄统计
• 计算逻辑：以每个月的最后一天作为月度周期的终点，累计满12个完整月度周期即计为1年
  代码示例：

$date1 = date_create("2015-01-01");
$date2 = date_create("2015-12-31");
$totalMonths = 0;
$currentPoint = clone $date1;
while (true) {
    // 计算当前所在自然月的最后一天
    $currentMonthEnd = date_create($currentPoint->format("Y-m-01"));
    $currentMonthEnd->modify("last day of this month");
    // 如果当前月的最后一天超过目标日期，停止累加
    if ($currentMonthEnd > $date2) {
        break;
    }
    $totalMonths++;
    // 将当前节点移动到下个月的第一天
    $currentPoint = (clone $currentMonthEnd)->modify("+1 day");
}
$calcYears = intdiv($totalMonths, 12);
$remainMonths = $totalMonths % 12;
echo "{$calcYears}年{$remainMonths}个月";

该逻辑下，从2015-01-01开始累计到12月月末时，刚好匹配目标日期，最终计算结果为1年。 #

内容的提问来源于stack exchange，提问作者Naveed Jasim