PHP DatePeriod 不包含结束日期时如何补齐

PHP 的 DatePeriod 用结束日期构造时，默认不会把结束日期放进遍历结果。PHP 8.2 及以上，结束日期正好是一个周期点时，给构造函数传入 DatePeriod::INCLUDE_END_DATE 即可；如果结束日期没有落在间隔序列上，则要先决定是“只列出周期点”，还是“业务上强制补一条终点记录”，两者不是同一件事。

官方手册：https://www.php.net/manual/en/dateperiod.construct.php

先确认 DatePeriod 的结束日期默认是排除的

下面的例子从 2026-06-01 开始，每 7 天递增，结束日期写成 2026-06-29。没有传 options 时，结果最后是 2026-06-22；这不是计算少了一次，而是 end 的默认语义就是排除。

format('Y-m-d'), PHP_EOL; // 观察最后一个实际递归点
}
// 2026-06-01、2026-06-08、2026-06-15、2026-06-22

这里的“最后一天”有两种含义：一种是按间隔计算出来的最后一个周期点，另一种是业务指定的日历结束日。先把这两个概念分开，后面的补齐策略才不会重复。

PHP 8.2 起用 INCLUDE_END_DATE 补齐周期终点

如果结束日期正好与间隔对齐，最小改法是把选项传给第四个参数。INCLUDE_END_DATE 是位字段选项；需要同时排除起点时，可以用按位或组合 EXCLUDE_START_DATE | INCLUDE_END_DATE。

format('Y-m-d'); // 先格式化成稳定的日期键，便于断言
}
echo implode(', ', $dates), PHP_EOL;
// 2026-06-01, 2026-06-08, 2026-06-15, 2026-06-22, 2026-06-29

PHP 官方手册记录该常量从 8.2.0 增加。不要只用 property_exists 判断业务结果：真正要检查的是遍历数组的最后一个日期，以及起点是否仍被包含。若代码支持多版本，可先在部署环境确认 PHP 版本，再选择兼容分支。

结束日期不对齐时不要盲目追加

例如起点是周一、间隔是 7 天，而结束日期是周三。即使打开 INCLUDE_END_DATE，业务仍应明确：你想要的是“每周节点”，还是“报表必须覆盖到 6 月 24 日”。前者不应凭空增加一个周三；后者才适合在遍历后补一条终点。

format('Y-m-d')] = $date; // 用日期字符串做键，天然避免重复
}
$endKey = $end->format('Y-m-d');
if (!isset($dates[$endKey])) {
    $dates[$endKey] = $end; // 只有业务要求覆盖终点时才手动补入
}
ksort($dates); // 让输出按日期顺序稳定排列
foreach ($dates as $date) {
    echo $date->format('Y-m-d'), PHP_EOL;
}

这段代码的补齐动作是业务规则，不是 DatePeriod 自动产生的周期点。若记录带有时间而不是纯日期，键应改为包含时区的完整格式；若终点必须落在“下一次周期”而不是指定日期，也应使用明确的加法规则，不能直接把 end 塞进数组。

兼容旧 PHP 版本并做结果检查

DatePeriod::INCLUDE_END_DATE 在 PHP 8.2 才加入。如果项目还要运行在更早版本，不能直接引用这个常量；可以采用“先遍历、再按键补齐”的兼容写法，并把版本差异留在一个小函数里。无论采用哪种方案，都建议固定时区、显式格式化结果，并为起点等于终点、结束日对齐和不对齐各写一条断言。

排查“少一天”时可按这张清单走：一看构造方式是否使用了 end 而不是固定次数；二看 options 是否包含结束日期；三看结束日期是否真的落在 DateInterval 序列上；四看起点和终点的时区及时间部分是否一致；五看手动补齐后是否与已有键重复。

常见问题

INCLUDE_END_DATE 能让任意结束日期都返回吗？

它用于包含周期的结束日期，但业务上仍要区分周期点和强制终点。非对齐日期需要额外的补齐规则，不能把它当作“自动补任意一天”。

为什么打开选项后结果数量变多了？

因为起点默认包含，选项又允许结束日期包含；当终点是有效周期点时，遍历结果自然会多出这一项。固定次数构造方式的计数规则也不同，应按实际遍历结果断言。

旧 PHP 版本怎样避免常量报错？

不要在旧版本直接引用该常量。将遍历和手动终点补入封装起来，用日期键去重，并在部署矩阵中分别测试 PHP 版本。

日期相同但时间不同会被误判重复吗？

如果业务只按自然日统计，可以统一使用 Y-m-d 键；如果需要区分时间点，则必须使用包含时区和时间的格式，不能为了去重丢掉时间信息。