如何用 PHP 生成时间区间序列？完整实践方法详解

做报表统计、日历展示或者账单分期时，经常需要把两个日期之间的时间切成一个序列。比如运营要查看最近 30 天每天的订单量，财务要按月拆分一个季度账单，这些都绕不开时间区间序列的生成。PHP 在这方面提供了相当完善的内置支持，只要用对方法，几十行代码就能覆盖绝大多数场景。不过在跨月、月末、夏令时这些边界上，不同写法的结果差异很大，值得仔细梳理一遍。

用 DatePeriod 快速生成序列

PHP 标准库里有三个类配合使用可以生成时间序列：DateTime 表示时间点，DateInterval 表示步长间隔，DatePeriod 负责按起点、间隔、终点迭代出序列。最典型的写法是构造一个起止日期和一个步长，然后直接用 foreach 遍历结果。由于 DatePeriod 实现了 Traversable 接口，它可以无缝接入 foreach、iterator_to_array 等语言结构，写起来非常自然。

<?php
$start = new DateTime('2024-01-01');
$end   = new DateTime('2024-01-31 23:59:59');
$interval = new DateInterval('P1D'); // 步长为 1 天

$period = new DatePeriod($start, $interval, $end);

foreach ($period as $date) {
    echo $date->format('Y-m-d') . PHP_EOL;
}

这里有几个细节需要注意。第一，DatePeriod 的结束边界是开区间，也就是说 $end 这个时间点本身不会出现在结果里，所以上例中把结束时间写到了当天最后一秒，确保 1 月 31 日被包含进来。第二，间隔字符串遵循 ISO 8601 标准，P1D 表示一天，PT2H 表示两小时，P1W2D 表示一周加两天，大小写含义不同，写错会直接抛异常。第三，如果只想拿到固定数量的元素而不是以终点为界，可以把第三个参数换成整数，表示迭代次数。

<?php
// 从今天开始，生成接下来的 7 天
$period = new DatePeriod(
    new DateTime('today'),
    new DateInterval('P1D'),
    7 // 迭代 7 次，包含起点
);

// 转成数组方便后续处理，比如配合 array_map、array_column
$days = iterator_to_array($period);
$formatted = array_map(fn($d) => $d->format('m-d'), $days);

按月生成序列的陷阱与解法

按天生成序列基本不会出问题，但按月生成时会出现一个经典陷阱。DateInterval 的 P1M 在底层是把日期加一个月，当起始日期是 1 月 31 日时，加上一个月得到 2 月 31 日，这个日期不存在，PHP 会把它归一化成 3 月 2 日或 3 月 3 日。这会导致后续序列整体漂移，比如每月底生成账单日时会越来越乱。先用一个例子看看这个问题。

<?php
$start = new DateTime('2024-01-31');
$end   = new DateTime('2024-07-01');
$period = new DatePeriod($start, new DateInterval('P1M'), $end);

foreach ($period as $date) {
    echo $date->format('Y-m-d') . PHP_EOL;
}
// 输出：2024-01-31、2024-03-02、2024-03-31、2024-05-01、2024-05-31
// 注意 3 月和 5 月各出现了两次，序列发生了漂移

解决这个问题的思路是每次都在月初的基础上操作。先把起点调整到当月 1 号，用 DatePeriod 生成每月 1 号的序列，再通过 modify 或 setDate 把日期设置回目标天数，并配合 last day of 处理月末溢出。另一种更直接的办法是利用 PHP 支持的相对时间表达式，比如 first day of next month，让日期解析器帮我们处理边界。

<?php
// 方案一：以每月 1 号为锚点生成，再修正到月末
$start = new DateTime('2024-01-01');
$end   = new DateTime('2024-06-01');
$period = new DatePeriod($start, new DateInterval('P1M'), $end);

foreach ($period as $firstDay) {
    // 修正为该月最后一天
    $lastDay = (clone $firstDay)->modify('last day of this month');
    echo $lastDay->format('Y-m-d') . PHP_EOL;
}
// 稳定输出每个月的月末：01-31、02-29、03-31、04-30、05-31

// 方案二：手动循环加首日锚点
$cursor = new DateTime('2024-01-31');
for ($i = 0; $i < 6; $i++) {
    echo $cursor->format('Y-m-t') . PHP_EOL; // t 表示当月天数
    $cursor->modify('first day of next month');
}

两种方案本质上是一样的：锚点固定在不随月份变化的日子上，序列就不会漂移。闰年的 2 月 29 日也会被 last day of this month 正确处理成 2 月 28 日，不需要自己写判断逻辑。如果是按周生成序列，情况相对简单，因为一周固定七天，直接用 P7D 或 P1W 步长即可，但要注意以周一还是周日作为一周起点，用 format('N') 判断并对齐到目标星期几即可。

封装可复用的时间序列工具函数

实际项目里，时间序列的生成往往还夹杂着额外需求：排除周末和节假日、按指定时区计算、返回字符串数组而不是 DateTime 对象等。把逻辑封装成通用函数能避免到处复制粘贴。下面给出一个比较完整的封装，支持三种粒度，并支持传入需要排除的日期集合。

<?php
/**
 * 生成时间区间序列
 * @param string $start     起始日期 Y-m-d
 * @param string $end       结束日期 Y-m-d（含）
 * @param string $unit      粒度：day / week / month
 * @param array  $excluded  需要排除的日期列表，格式 Y-m-d
 * @return array            日期字符串数组
 */
function generateDateRange(string $start, string $end, string $unit = 'day', array $excluded = []): array
{
    $intervalMap = [
        'day'   => 'P1D',
        'week'  => 'P7D',
        'month' => 'P1M',
    ];
    if (!isset($intervalMap[$unit])) {
        throw new InvalidArgumentException('不支持的粒度：' . $unit);
    }

    $begin = new DateTime($start);
    $finish = (new DateTime($end))->modify('+1 day'); // 闭区间转开区间

    if ($unit === 'month') {
        // 月粒度用 1 号做锚点，避免月末漂移
        $begin->modify('first day of this month');
        $finish->modify('first day of next month');
    }

    $period = new DatePeriod($begin, new DateInterval($intervalMap[$unit]), $finish);

    $result = [];
    $excludedSet = array_flip($excluded);
    foreach ($period as $date) {
        $key = $date->format('Y-m-d');
        if ($unit === 'month') {
            $key = $date->format('Y-m-t'); // 取每月最后一天展示
        }
        if (isset($excludedSet[$key])) {
            continue;
        }
        $result[] = $key;
    }
    return $result;
}

// 使用示例：生成一月到三月的月末序列，排除指定日期
print_r(generateDateRange('2024-01-01', '2024-03-31', 'month', ['2024-02-29']));

时区问题也值得一提。所有 DateTime 对象创建时都会绑定一个时区，默认取 php.ini 中的 date.timezone 配置。如果服务器和应用使用了不同时区，或者业务上明确要求按东八区计算，最好在创建对象时显式传入 DateTimeZone，避免序列边界出现偏差。夏令时地区在按天迭代时，某天可能只有 23 小时，但因为 DatePeriod 按日历天数推进，结果仍然是正确的，这一点比手动做时间戳加法可靠得多——手动给时间戳加 86400 秒在夏令时切换日就会跳过或重复一天。

<?php
// 显式指定时区，保证跨环境一致性
$tz = new DateTimeZone('Asia/Shanghai');
$start = new DateTime('2024-03-01', $tz);

// 反例：手动加秒数在夏令时日会出错
// 正确做法是依赖 DateTime 的日历运算
$next = (clone $start)->modify('+1 day');

总结一下，日常按天或按周生成序列，DatePeriod 加 DateInterval 是最简洁可靠的选择；按月生成务必使用月初锚点规避漂移问题；需要排除节假日、自定义粒度时，封装一层工具函数统一入口。掌握这几个模式之后，报表补齐日期轴、日历组件渲染数据、分期账单拆分这类需求都能轻松应对，代码也会更健壮。

PHP时间区间DatePeriod修改时间：2026-09-03 02:26:05