Unix 时间戳转换工具使用说明

Unix 时间戳排查先判断单位，再判断时区

时间戳问题通常不是转换公式错误，而是单位和时区被混用。10 位数字多为秒级时间戳，13 位数字多为毫秒级时间戳，16 位可能是微秒级，19 位可能是纳秒级。JavaScript 的 Date 通常使用毫秒；很多后端日志、数据库和 API 则使用秒。单位错一档，时间会偏到 1970 年或远未来。

可复制样例

秒级：1717203600
毫秒级：1717203600000
同一时间只是在单位上相差 1000 倍。

把秒级值直接传给 JavaScript new Date() 会被当作毫秒处理，得到接近 1970 年的时间。反过来，把毫秒级值当作秒传给后端，也会得到异常未来日期。

时区排查流程

1. 用 Unix 时间戳工具 先确认单位。
2. 记录转换出的 UTC 时间和本地时间，不要只截取一个显示值。
3. 检查日志来源时区、服务器时区、数据库时区和浏览器时区。
4. 跨系统比较时统一转成 ISO 8601 或 UTC，再回到本地展示。

常见误判

“差 8 小时”或“差 9 小时”通常是 UTC 与本地时区展示差异，不一定是数据错误。真正需要关注的是同一时间在多个系统里是否表示同一个瞬间。用户所在时区、服务器部署区域和业务结算时区可能不同，不能只看页面显示。

参考依据

浏览器时间处理可参考 MDN Date.prototype.getTime()。涉及账单、交易、合同生效和日志取证时，应以系统记录的原始时间戳、时区字段和后端审计日志为准。