AWS Lambda Powertools TypeScript 日志时间戳格式问题解析

在 AWS Lambda Powertools for TypeScript 项目中，开发者发现了一个关于日志时间戳格式的有趣问题。当 Lambda 函数的环境变量 TZ 设置为非 UTC 值时，日志系统在某些情况下会生成不符合 ISO 8601 标准的时间戳格式。

问题现象

具体表现为：当 Lambda 函数在午夜时分（00:00:00）记录日志时，生成的时间戳会显示为 2025-05-09T24:00:33 这样的格式。这种格式在 ISO 8601 标准中是不合规的，正确的表示应该是 2025-05-10T00:00:33。

技术背景

这个问题源于 JavaScript 的 Intl.DateTimeFormat API 在不同 Node.js 版本中的实现差异。该 API 用于国际化日期时间格式化，但在处理某些时区的午夜时间时，会输出 24 小时制的表示方式。

ISO 8601 标准明确规定：

• 小时部分应该使用 0-23 的表示法
• 24:00 只允许表示当天的结束时刻（即第二天的 00:00）
• 24:00:33 这样的时间表示是不符合规范的

影响范围

经过测试，这个问题在不同 Node.js 运行时环境中表现不同：

• Node.js 22：正确处理，输出 00:00 格式
• Node.js 20：存在问题，输出 24:00 格式
• Node.js 18：同样存在问题

解决方案

项目团队采纳了社区贡献的解决方案，通过指定 Unicode 扩展来强制使用 0-23 小时制。具体实现是在 Intl.DateTimeFormat 的 locale 参数中添加 u-hc-h23 扩展：

return new Intl.DateTimeFormat('en-u-hc-h23', {
  year: 'numeric',
  month: twoDigitFormatOption,
  day: twoDigitFormatOption,
  hour: twoDigitFormatOption,
  minute: twoDigitFormatOption,
  second: twoDigitFormatOption,
  hour12: false,
  timeZone: validTimeZone,
});

这个修改确保了无论 Node.js 版本如何，都会生成符合 ISO 8601 标准的时间戳格式。

临时解决方案

对于暂时无法升级到 Node.js 22 的用户，可以采用以下临时方案：

1. 创建自定义日志格式化器
2. 在格式化器中应用上述 Unicode 扩展
3. 等待官方修复后移除自定义代码

总结

这个问题展示了国际化日期时间处理中的一些微妙之处，特别是在跨不同 JavaScript 运行时环境时可能遇到的兼容性问题。AWS Lambda Powertools for TypeScript 团队通过添加 Unicode 扩展的方式，确保了日志时间戳的一致性和标准合规性，为开发者提供了更可靠的日志记录功能。

该修复已包含在 v2.23.0 版本中发布，建议用户升级以获得更稳定的日志记录体验。