时间戳转换器

如何使用 Epoch Converter

1. 需要实时 epoch 值时，查看当前时间戳面板中的秒或毫秒。
2. 粘贴时间戳，选择秒或毫秒，再选择时区并转换为可读日期。
3. 输入日期和时区，为 API、日志或数据库查询生成对应的 epoch 值。
4. 使用时间计算行，从当前时间增加或减去年、月、日、时、分、秒。

常见使用场景

• 调试时解码 created_at、expires_at、iat、exp 或 event_time 等 API 字段。
• 检查 JWT 过期时间、缓存 TTL 或签名 URL 截止时间是否已过去。
• 把生产日志时间戳转换成本地时区，再对比事故时间线。
• 为前端 fixture、数据库过滤条件或定时任务生成精确测试时间。

秒、毫秒和时区

Unix time 从 1970-01-01 00:00:00 UTC 起累计经过时间。同一瞬间可以用多个时区显示，但 epoch 值本身不依赖时区。

• 秒： 现代日期通常是 10 位，常见于 Unix 工具和许多 API。
• 毫秒： 通常是 13 位，常见于 JavaScript Date.now() 和浏览器日志。
• 时区显示： 把时间戳转成 Asia/Shanghai 或 UTC 只改变显示的钟表时间，不改变那个瞬间。
• 日期输入： 需要精度时，应写完整年、月、日、时、分、秒，避免歧义。

Epoch 秒与 JavaScript 日期

JavaScript Date 内部使用毫秒，而很多后端系统和命令行工具使用 epoch 秒。转换结果看起来明显不对时，第一步应检查单位。

时间戳位数与单位速查

很多时间转换错误不是日期算法问题，而是把秒、毫秒、微秒或纳秒当成同一种单位。

• 10 位通常是 epoch 秒，例如 1720000000。
• 13 位通常是毫秒，例如 JavaScript Date.now()。
• 16 位常见于微秒，19 位常见于纳秒；用于页面展示前通常要先除以 1000 或 1000000。

时区排错清单

同一个 epoch 值代表同一瞬间，时区只影响显示。遇到相差 8 小时、9 小时或整天的问题，先按这个顺序排查。

• 确认原始值是否已经是 UTC epoch，而不是本地时间字符串。
• 确认输入日期是否带时区；没有时区的日期字符串常被浏览器按本地时区解释。
• 比较日志时统一显示为 UTC，再按需要转换到 Asia/Shanghai、America/New_York 等业务时区。