时区偏移计算错误
快速摘要
你把 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 或本地)
跨时区运算一律使用时区感知库