时间戳表示的是瞬间
Unix 时间戳通常表示从 1970-01-01 00:00:00 UTC 起经过的秒数。它描述全球可比较的瞬间,本身不带时区信息。不同地点的人看到同一个时间戳时,可能得到不同日期和钟点,但这个瞬间没有改变。把时间戳误认为“北京时间”是常见错误。
Unix 时间戳 0 对应 1970-01-01 00:00:00 UTC,在北京时间 UTC+8 下显示为 1970-01-01 08:00:00。反过来,北京时间 2024-01-01 08:00:00 与 UTC 的 2024-01-01 00:00:00 是同一时刻,因此对应时间戳 1704067200。先统一成 UTC 瞬间,再按目标时区展示,能避免加减八小时时方向弄反。
秒、毫秒与负数时间
不同系统采用的单位可能不同。1704067200 是秒级时间戳,1704067200000 是同一时刻的毫秒级时间戳,两者相差 1000 倍。接口应明确单位为秒还是毫秒,并在输入边界检查数值范围;日志中记录原始值和单位能缩短排查时间。
时间戳也可以为负数,用来表示 1970 年基准点之前的时刻,例如 -1 表示该基准点前一秒。日常业务通常基于 POSIX 时间模型;高精度天文时间需采用专门时标。系统应明确精度、单位和有效范围。
时区决定显示结果
假设服务器把 1704067200 按 UTC 输出为 2024-01-01T00:00:00Z,结尾的 Z 表示 UTC。北京用户按 Asia/Shanghai 显示时会得到 2024-01-01 08:00:00。若服务器又按本地时间加八小时,就会把瞬间推迟八小时。排查时确认输入、解析和输出分别使用什么时区。
不带时区的本地时间字符串信息不足。例如 2024-01-01 00:00:00 究竟是哪个时区的零点,需要上下文约定。跨系统传输可使用带 Z 或明确偏移的 ISO 8601 字符串,也可以传输整数时间戳,并在关键转换处记录时区名称。
跨时区验证流程
先选一个公开可核对的基准值,例如 1704067200 对应 UTC 的 2024-01-01 00:00:00。分别按 UTC、Asia/Shanghai 和 America/New_York 格式化,检查北京结果快八小时,纽约按当地规则落到前一日。再使用夏令时切换附近的日期,避免把时区理解成固定偏移。
然后执行往返测试:解析带时区的本地字符串,转换为时间戳,再格式化回原时区,确认结果一致。非法日期、超范围时间戳以及秒毫秒混用时应有明确规则。页面可标记 UTC,日志保留时间戳与 ISO 字符串,便于沿同一时间轴定位问题。