Skip to content

时区偏移计算错误

快速摘要

你把 getHours(本地)与 getUTCHours 混用,或忘了 getTimezoneOffset 的符号——结果时间偏差数小时。

为什么发生

  • 本该用 UTC 却用了 getHours(或反之)

  • 忘了 getTimezoneOffset 返回的分钟符号是反的

  • 存储本地时间字符串却在显示时当作 UTC

最小示例

✗ 错误代码
const d = new Date('2023-06-15T12:00:00Z');
const localHour = d.getHours(); // varies by zone
const utcHour = d.getUTCHours(); // 12
console.log(localHour + utcHour); // mixing zones — meaningless
✓ 修复代码
const d = new Date('2023-06-15T12:00:00Z');
const utcHour = d.getUTCHours(); // 12
const utcMinute = d.getUTCMinutes(); // 0
console.log(`UTC: ${utcHour}:${utcMinute}`); // consistent UTC

把 getHours(本地)与 getUTCHours(UTC)混用会合并不同参照系的值。只用 UTC 方法可保持运算一致。

如何诊断

  • 以本地和 UTC 两种格式打印日期查看差距

  • 检查每个 get* 与 getUTC* 调用是否一致

  • 把算出的偏移与已知时区差对比

如何修复

  • 值为 UTC 时只用 UTC 方法(getUTC*),为本地时只用本地方法

  • 用能显式处理时区运算的库(dayjs、date-fns-tz)

  • 以带偏移的 ISO 8601 存储与传输日期,显示时再转换

如何预防

  • 全代码库统一约定(UTC 或本地)

  • 跨时区运算一律使用时区感知库

相关资源

相关术语

相关课程

← 返回语言