时间戳差 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 点,否则出差一次就错。
这页提到的工具