时间戳差 8 小时,问题通常不在时间戳

2026-11-08 · Demo_Li

「日志里说 11:00 出的问题,用户说的是 19:00」——这类八小时偏差,几乎都是 UTC 和东八区混在一起算了。

先分清三种时间

  • Unix 时间戳:从 1970-01-01 00:00:00 UTC 起算的秒数或毫秒数。它本身不带时区,是一个绝对时刻。这是它最大的优点。
  • ISO 8601 带时区:2026-11-08T00:47:00+08:00,明确写了偏移量,没有歧义。
  • 不带时区的日期字符串:2026-11-08 00:47:00。这一种最危险,因为它看起来和上面一样,但没有任何时区信息,谁解析就按谁的本地时区算。

前端 new Date("2026-11-08 00:47:00") 按浏览器本地时区解析,Python 的 datetime.fromisoformat 保留原始值不做时区推断,Node 的 new Date("2026-11-08") 又把纯日期当成 UTC。三处都能跑,结果差八小时。

一个能立刻验证的判断法

把同一个时刻分别算成秒级时间戳,看是否相同。相同则是同一个绝对时刻,只是显示层的问题;不同则是某一层把本地时间当成了 UTC。

页面顶部那个实时时间戳就是干这个用的:和日志里的数字直接比,不用先做转换。

通常应该在哪一层修

我的做法是:存储和传输一律用 UTC 时间戳,只有显示时才转本地时区。

  • 数据库存整数秒或带时区的类型,不要存不带时区的日期时间。
  • 接口返回 ISO 8601,且必须带 Z 或 +08:00。
  • 前端格式化只用 Intl.DateTimeFormat 或 toLocaleString,不要自己拼字符串。

这样只有显示层会出问题,排查范围小得多。

几个容易忽略的点

毫秒和秒混用。13 位是毫秒,10 位是秒。把秒当毫秒会得到 1970 年,把毫秒当秒会得到五万多年后的日期。看到 1970-01-01 就该想到这个。

中国没有夏令时,UTC+8 全年固定,所以国内业务相对简单。但只要涉及海外用户、云厂商日志(通常是 UTC)或者跨时区的定时任务,就必须显式处理。

Unix 时间戳不计算闰秒。绝大多数系统选择忽略或用平滑方式处理。做高精度计时时,别指望时间戳的差值等于真实经过的秒数。

用户选的时间不等于用户所在时区。让用户填「每天 9 点提醒」,还要问清是哪个时区的 9 点,否则出差一次就错。

这页提到的工具

打开全部工具 →