Laravel Carbon Y-W格式转换报错问题求助

我之前也碰到过一模一样的问题，这其实是Y-W格式自带的两个“坑”导致的：

问题根源 #

1. 缺少周内具体日期信息：Y-W只指定了年份和周数，但没明确这一周的哪一天。Carbon（底层依赖PHP的DateTime）没法仅凭年份和周数确定唯一日期，解析时会因为信息不足报错，或者返回完全不符合预期的结果。
2. 日历年份与ISO周数不匹配：W是ISO-8601标准的周数，而Y是日历年份。比如2018年1月1日实际上属于2017年的第52周，用format('Y-W')会得到2018-52——这个组合本身不符合ISO规则，解析时自然会出错。

解决方案 #

第一步：修正存储时的格式（关键） #

把存储时的Y-W换成o-W，其中o是ISO周对应的年份，它会自动匹配周数的正确年份，彻底避免年份和周数不匹配的情况：

// 修正后的存储代码
$weekDate = Carbon::createFromFormat('d-m-y', "{$key}")->format('o-W');
DB::table('backorder_voorspelling')->insert([
    'artikelcode' => $articlecode,
    'week' => $weekDate,
    'aantal' => $value,
    'created_at' => Carbon::now(),
    'updated_at' => Carbon::now()
]);

第二步：正确解析回Carbon实例 #

现在我们有了合法的ISO周格式（年份+周数），接下来需要明确解析成该周的某一天（比如周一，也就是ISO周的起始日），有两种实用方法：

方法1：直接在格式中指定星期几

在解析时补充-1表示周一（ISO标准中周一为一周的第一天）：

$startOfWeek = Carbon::createFromFormat('o-W-1', "{$row->week}-1");

方法2：先解析再调整到周起始

如果需要灵活指定周的起始日（比如周日），可以先解析再用startOfWeek()方法调整：

// 解析后调整到周的周一（默认就是周一，也可以指定Carbon::SUNDAY）
$startOfWeek = Carbon::createFromFormat('o-W', $row->week)->startOfWeek();

要是因为历史数据原因没法修改存储的Y-W格式，也可以用同样的思路补充星期几来解析，但要注意可能存在的年份周数不匹配问题，必要时可以捕获异常做兼容处理。

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