周报文件叫 2019-W01 不一定是星期一写错了。假如这周第一天是 2019 年 12 月 30 日,按 ISO 周编号,它实际上属于 2020-W01。把日历日期开头的四位数和 isocalendar() 里的周次直接拼起来,会造出一个看似合理、实际分桶错误的键。

年末和年初都用同一规则验证

将日期送入 Python 的 date.fromisoformat(...).isocalendar(),取结果的三个字段:周年、周次、星期。2019 年 12 月 29 日是 2019 年第 52 周第 7 天,次日却是 2020 年第 1 周第 1 天。另一个方向上,2021 年 1 月 1 日仍属于 2020 年第 53 周,直到 1 月 4 日才进入 2021 年第 1 周。

from datetime import date
for value in ['2019-12-29', '2019-12-30', '2021-01-01']:
    year, week, day = date.fromisoformat(value).isocalendar()
    print(value, f'{year}-W{week:02d}', day)
本机对照:日期还在十二月,怎么归到明年
本机对照:日期还在十二月,怎么归到明年

ISO 周以星期一开始,第一周含该自然年的第一个星期四。因此一周可能横跨两个日历年,填周年时要看整周归属。报表要的是本地业务日,就先将每条带偏移的日志换算到业务时区再取日期;把仍是 UTC 的日期错归到昨日或明日,同样会改变分桶。这里输入的是已经确定的公历日期,没有为其选择时区。

辅助判读:日历年与 ISO 周年
辅助判读:日历年与 ISO 周年

如果数据库和脚本并行生成这份报表,让两端用这几个日期各算一次。核对的对象是最终分组键,别只比较日期字段本身。

可在日期格式转换先核对待统计的日期,再通过 year, week, _ = d.isocalendar() 获得周键。跨时区导入时也可以参照重叠时刻怎样保留偏移量留原始时刻。给旧数据重新分桶前,先检查报表想用 ISO 周、当地周还是财务周,别直接换掉口径。验收时至少留两条跨年样例:一条十二月已计入下一周年,一条一月仍计入上一周年。