php 8.2 的 datetime 扩展主要引入了对 iso 8601 week date（iso 8601 周日期）的原生支持，并修复了部分时区处理中的边界情况。开发者现在可以直接使用 datetime::createfromformat() 解析 %v、%u 等格式符，或者通过 dateperiod 按周进行迭代，无需再依赖第三方库或手动计算年份与周的对应关系。
如何解析和生成 ISO 8601 周日期
在 PHP 8.2 之前，虽然 date() 函数支持 W 格式化输出周数，但 DateTime 对象在处理包含周信息的输入字符串时往往需要借助 strtotime() 这种相对模糊的方式，或者手动拼接日期。PHP 8.2 正式将 ISO 8601 周日期纳入标准支持范围，允许直接解析形如 2023-W45-5 （2023年第45周周五）的字符串。
<?php
// 解析 ISO 8601 周日期：年-第W周-星期u
$date = DateTime::createFromFormat('Y-W-u', '2023-W45-5');
echo $date->format('Y-m-d') . "\n"; // 输出: 2023-11-10
// 生成 ISO 8601 周日期字符串
echo $date->format('o-W-N') . "\n"; // 输出: 2023-45-5
?>
上述代码展示了如何使用 Y-W-u 格式符解析输入。其中 Y 代表 ISO-8601 周年份（可能与公历年不同），W 是周数（01-53），u 是星期几（1=周一，7=周日）。生成的结果同样可以通过 o-W-N 格式还原为周日期字符串。这种处理方式比传统的 Y-m-d 更精确地表达了“某年的第几周”这一概念，特别是在跨年周的处理上避免了歧义。
立即学习“PHP免费学习笔记（深入）”；
DatePeriod 如何按周迭代时间序列
当需要按周为单位遍历时间段时，PHP 8.2 之前的版本通常需要使用 DateInterval 配合 add() 方法循环累加，或者手动计算起始和结束日期。PHP 8.2 增强了 DatePeriod 的灵活性，使其能更自然地处理基于周的间隔。结合新的周日期解析能力，可以构建出清晰的周迭代逻辑。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
<?php
$start = new DateTime('2023-W01-1');
$end = new DateTime('2023-W52-1');
$interval = DateInterval::createFromDateString('1 week');
$period = new DatePeriod($start, $interval, $end);
foreach ($period as $date) {
echo $date->format('Y-W-N') . "\n";
}
?>
这段代码演示了从 2023 年第 1 周周一到第 52 周周一的迭代过程。通过 DateInterval::createFromDateString('1 week') 创建周间隔，DatePeriod 会自动处理跨月、跨年的情况。由于起始点使用了 ISO 周日期解析，确保了迭代的起点严格对应“周一”，避免了因月份天数差异导致的偏移。这种模式适用于周报生成、按周统计等业务场景。
ISO 周日期与普通日期的转换差异是什么
在处理跨年周时，ISO 8601 周日期与普通公历日期存在显著差异。例如，2023 年 1 月 1 日是星期日，属于 2022 年的第 52 周。如果使用普通日期解析，可能会错误地将其归入 2023 年第 1 周。PHP 8.2 提供的 o（ISO 周年份）和 W（周数）格式符能准确反映这一关系。
以下代码验证了这一差异：
<?php
$date = new DateTime('2023-01-01');
echo $date->format('Y-W-o') . "\n"; // 输出: 2023-52-2022
?>
结果显示，尽管公历年份是 2023，但其 ISO 周年份 o 为 2022，周数 W 为 52。这意味着在进行周维度聚合时，应优先使用 o-W 组合而非 Y-W，以确保数据归属的正确性。PHP 8.2 并未改变这一数学规则，而是提供了更便捷的解析和生成接口，使开发者能更容易地遵循 ISO 8601 标准。
