Day.js中ISO周格式化的正确使用方式

在JavaScript日期处理库Day.js中，处理ISO周数时开发者可能会遇到一个常见误区。本文将通过一个典型场景，解析如何正确获取ISO标准的年份和周数组合。

问题现象

当使用Day.js处理跨年周的日期时，比如2019年12月29日（实际属于2020年的第一周），直接使用YYYY-WW格式会得到2019-01的错误结果。这是因为：

const firstDay = dayjs().year(2020).month(1).date(4)
  .isoWeek(1).startOf('isoWeek');
// → Sun, 29 Dec 2019 23:00:00 GMT

firstDay.format('YYYY-WW'); // 输出2019-01（不符合预期）

原因分析

1. YYYY代表的是日历年（Calendar Year），而非ISO周年（ISO Week Year）
2. ISO周年的定义与日历年不同，可能跨年
3. 2019年12月29日属于2020年的第一周，但日历年在2019年

正确解决方案

Day.js提供了专门的ISO周年标识符：

firstDay.format('GGGG-WW'); // 正确输出2020-01

其中：

• GGGG：ISO 4位数年份
• WW：ISO 2位数周数（已补零）

扩展知识

ISO周系统特点：

1. 每周从周一开始
2. 第一周包含当年第一个星期四
3. 一年可能有52或53周
4. 跨年周可能属于下一年

其他相关格式化符号：

• GG：ISO 2位数年份
• W：不补零的周数
• wo：带序数的周数（如"1st"）

最佳实践建议

1. 处理周数相关逻辑时始终使用ISO标准格式
2. 明确区分日历年和ISO周年
3. 在显示给用户时考虑添加说明文字
4. 进行跨年日期计算时特别注意周数的归属

通过正确理解和使用Day.js的ISO周格式化功能，可以避免日期处理中的常见陷阱，确保业务逻辑中的周数计算准确无误。