首页 > 文章 > php教程

PHP DatePeriod 是否包含结束日期该看哪个参数

来源：17golang原创

时间：2026-09-14 12:39:57 355浏览收藏

PHP 的 DatePeriod 按结束日期构造时，结束日期默认不在迭代结果里。要把它纳入结果集，关键参数是第四个参数：DatePeriod::INCLUDE_END_DATE。它控制的是日期边界，不是把间隔自动补到结束日；如果按天递增无法刚好落在结束时刻，打开选项也不会凭空生成一个不符合间隔的日期。

要点速览

end 模式默认包含开始日期、排除结束日期。
用 DatePeriod::INCLUDE_END_DATE 显式包含结束日期，并可和 EXCLUDE_START_DATE 组合。
recurrences 是构造参数里的重复次数；不要直接把它当成 foreach 返回条数。

先分清按结束日期还是按次数构造

DatePeriod 常见有两种思路：第三个参数传 DateTimeInterface，表示“迭代到哪个结束日期”；传整数，则表示“重复多少次”。这两种写法看起来只差一个参数类型，但边界规则不同，排查日期少一天时要先确认这一点。

构造方式	默认边界	应该观察什么
`start, interval, end`	开始包含，结束排除	最后一次日期是否严格早于 end
`start, interval, recurrences`	开始默认包含	构造次数与迭代数量的关系

PHP DatePeriod start interval end options 与结束日期包含排除关系示意图 — 图1：DatePeriod 构造参数与结束日期边界的结构示意图，默认边界与 INCLUDE_END_DATE 的作用互相对照。

用 INCLUDE_END_DATE 明确表达结束日期

下面的例子以每天为间隔。第一段使用默认行为，第二段通过选项把 9 月 5 日纳入结果。代码里的注释特意保留边界意图，后续维护者不必凭经验猜第四个参数。

format('Y-m-d'), PHP_EOL;
}
// 预期的示意结果：2026-09-01 到 2026-09-05

这里的 INCLUDE_END_DATE 是位字段选项。如果还需要排除开始日期，可以用按位或组合：DatePeriod::EXCLUDE_START_DATE | DatePeriod::INCLUDE_END_DATE。不要把它写成两个独立参数，构造函数只接收一个 options 整数。

用迭代结果和属性确认边界

只看代码里的参数不够，实际业务通常还要确认配置是否被正确传递。PHP 8.2 及以后可以读取 include_end_date 属性；更通用的办法是格式化迭代出的最后一个值，与业务结束日期比较。

include_end_date); // bool(true)

$last = null;
foreach ($inclusive as $date) {
    // DatePeriod 迭代得到 DateTimeInterface 对象。
    $last = $date->format('Y-m-d');
}

// 仅在最后日期确实相等时，才认定 end 已落入结果。
if ($last === $end->format('Y-m-d')) {
    echo 'end included', PHP_EOL;
}