开发实操 · 可复现示例

秒、毫秒与时区:避免日志时间差八小时

用 Unix 零点和固定日期核对秒与毫秒,明确北京时间、UTC 和浏览器本地时间,排查 JWT 过期判断与定时任务偏差。

由 DevTools 极客工具箱 维护 · 更新于

时间戳表示时刻,时区决定显示

同一个时刻可以显示成北京时间上午八点,也可以显示成 UTC 零点。Unix 时间戳本身不携带北京时间或美国时间这样的显示时区。

先在 时间戳工具 输入 0 并明确选择秒,应得到:

UTC / ISO: 1970-01-01T00:00:00.000Z
北京时间: 1970-01-01 08:00:00

这两个结果指向同一个时刻。若一个工具把浏览器本地时间直接标成“北京时间”,身在其他时区的用户就会得到错误标签。本页的北京时间输出使用 UTC+08:00,与浏览器当前时区分开处理。

不要只靠位数猜单位

当前年代常见秒时间戳为 10 位、毫秒为 13 位,但早期日期、负数或遥远未来的长度可能不同。对账、回放历史日志和测试边界值时,应明确选择单位。

下面两个数表示同一时刻:

new Date(1704067200 * 1000).toISOString();
// '2024-01-01T00:00:00.000Z'
new Date(1704067200000).toISOString();
// '2024-01-01T00:00:00.000Z'

如果直接写 new Date(1704067200),JavaScript 会按毫秒解释,得到接近 1970 年的日期。API 文档中应明确写明字段单位,变量名也可采用 createdAtSeconds 或 createdAtMs 减少混淆。

无时区字符串是八小时偏差的常见来源

2024-01-01 08:00:00 单独出现时,无法判断它属于哪个时区。本站日期输入区提供北京时间、UTC 和浏览器本地时区选项。选择北京时间后,这个值应转换成 1704067200 秒。

跨系统传输时,更适合采用明确偏移的 ISO 8601:

2024-01-01T08:00:00+08:00
2024-01-01T00:00:00Z

两者都表示 UTC 零点。带时区的输入以自身偏移为准,不应再额外加减八小时。对于无时区输入,先确认业务约定再转换。不要把本地显示字符串加上 Z 就当成 UTC,这会改变它表示的时刻。

JWT 的 exp 使用秒

JWT 的 exp 等 NumericDate 声明通常使用从 Unix 起点计算的秒。与 Date.now() 的毫秒直接比较,会产生错误的过期判断:

const expired = Date.now() >= payload.exp * 1000;

这段代码只是展示单位换算,不是完整的认证逻辑。服务端仍需验证签名、算法、发行者、受众和适当的时钟容差。客户端本机时钟也可能不准,所以 JWT 调试工具 的状态只用于检查。

CRON 还依赖调度器的时区

五字段 0 9 * * 1-5 表达工作日 09:00,但具体对应哪个 UTC 时刻,由调度器时区决定。CRON 工具 展示字段规则,不会替你设置服务器时区。部署时要在调度器文档与运行日志中核对配置,尤其注意有夏令时地区的重复或缺失时刻。

排查顺序可以固定为:确认时间戳单位 → 用 ISO 输出核对同一时刻 → 确认显示时区 → 核对机器时钟 → 检查调度器设置。若仍有偏差,保留原始数值和时区信息,比只截取页面上的日期更有帮助。

技术依据

已成功复制到剪贴板