Day.js 中如何正确验证 ISO 8601 格式字符串

在 JavaScript 日期处理库 Day.js 中，验证 ISO 8601 格式的日期时间字符串是一个常见需求。这类字符串通常形如 "2025-03-21T08:03:21.984Z"，包含日期、时间、毫秒和时区信息。

常见误区

许多开发者会尝试使用类似 'YYYY-MM-DDTHH:mm:ss.SSSZ' 这样的格式字符串进行验证，但往往会发现验证失败。这是因为 Day.js 对格式字符串的解析有其特定的规则。

正确验证方法

在 Day.js 中，要正确验证 ISO 8601 格式字符串，需要使用方括号将特殊字符 Z 包裹起来：

dayjs('2025-03-21T08:03:21.984Z', 'YYYY-MM-DDTHH:mm:ss.SSS[Z]', true).isValid()

这种写法告诉 Day.js 解析器：

1. YYYY-MM-DD 表示年-月-日
2. T 是日期和时间之间的分隔符
3. HH:mm:ss.SSS 表示时:分:秒.毫秒
4. [Z] 表示字面量的 Z 字符（UTC 时区标识）

技术原理

Day.js 的严格模式验证（第三个参数为 true）要求格式字符串必须精确匹配输入字符串。ISO 8601 格式中的 Z 字符表示 UTC 时区，在格式字符串中需要用方括号包裹，否则 Day.js 会将其解释为时区偏移量解析指令。

实际应用建议

1. 对于纯 ISO 8601 格式验证，可以直接使用 Day.js 的默认解析功能，无需指定格式：

   dayjs('2025-03-21T08:03:21.984Z').isValid()
   

2. 当需要同时验证格式和内容时，才需要使用带格式字符串的严格验证模式。

3. 在处理用户输入时，建议先进行基本的字符串格式检查，再使用 Day.js 进行日期验证，以提高性能和准确性。

总结

Day.js 提供了灵活的日期时间验证功能，理解其格式字符串的解析规则对于正确处理各种日期格式至关重要。对于 ISO 8601 格式，特别注意时区标识符 Z 需要用方括号包裹才能在严格模式下正确验证。