完整使用说明

时间戳转换器使用指南

这份指南帮助你快速在 Unix 时间戳和可读日期时间之间来回转换,尤其适合日志排错、接口联调和秒/毫秒单位核对。

开始使用计算器

完整使用说明

这个计算器能做什么

如果你经常看日志、调接口、查数据库或排查前后端时间格式,时间戳问题几乎总会出现。最典型的麻烦有两个:一是不确定这个数字到底是秒还是毫秒,二是不确定页面里输入的日期时间到底被当成 UTC 还是本地时间。这个时间戳转换器就是帮你快速把这两个问题拆开看清楚。

它支持把 Unix 风格时间戳转换成可读日期时间,也支持把浏览器里的本地日期时间转换成时间戳,并允许你在秒和毫秒两种常见单位之间切换。它很适合开发调试、内容核对、手动验算接口字段和快速做格式确认。

什么时候适合用它

  • 你要把日志、数据库或接口里的时间戳翻译成人能看懂的时间。
  • 你要把一个已知日期时间生成秒级或毫秒级时间戳。
  • 你在排查前后端到底使用的是秒还是毫秒。
  • 你想在浏览器里快速验证时间格式,而不想打开代码环境。

输入项说明

时间戳

这里输入的是整数型 Unix 时间戳。当前页面会按你选择的单位把它理解为秒或毫秒。

如果你看到的数字是 10 位左右,通常更像秒;如果是 13 位左右,通常更像毫秒,但最好仍用页面实际验证一次。

日期时间

日期时间通过浏览器的 datetime-local 输入框填写。它更接近“本机本地时间”的输入方式,不会自动携带明确时区标签。

单位模式

当前页面支持:

  • 毫秒

单位模式会同时影响两个方向的换算,所以在点击按钮前,先确认模式是否正确非常重要。

计算逻辑说明

当前页面有两个独立动作:

  • 把时间戳转换成可读日期时间
  • 把本地日期时间转换成时间戳

在“时间戳转日期时间”时:

  • 秒模式会直接按秒解释输入值
  • 毫秒模式会先除以 1000,再按秒级结果格式化输出

在“日期时间转时间戳”时:

  • 页面会把本地日期时间先转成 Unix 秒级时间戳
  • 如果你选择的是毫秒模式,再把结果乘以 1000

这也是为什么同一组输入,在秒和毫秒模式下会得到不同数量级结果。

示例

假设你在日志里看到 1710000000,不确定它代表什么。

你可以先选“秒”模式,把它转换成日期时间,看看是否落在合理范围;如果结果明显不对,再切到“毫秒”模式重复一次。这样通常很快就能判断接口到底使用的是哪种单位。

反过来,如果你已经知道一个本地时间点,也可以输入日期时间,再决定生成秒级还是毫秒级时间戳,直接用于接口测试或脚本参数。

如何看懂结果

时间戳结果

这是你输入的本地日期时间对应的 Unix 整数值。更适合拿去做接口传参、日志核对或数据库比对。

日期时间结果

这是把时间戳翻译成可读字符串后的结果,更适合用来判断“这个数字到底是不是我要找的那个时间”。

本地时间假设

页面不会额外写出时区标签,因此你应该默认它使用浏览器当前环境来解释日期时间输入。

常见错误

  • 把 10 位秒时间戳和 13 位毫秒时间戳混用。
  • 误以为 datetime-local 输入框表达的是 UTC。
  • 切换单位后忘了重新按正确方向转换。
  • 拿页面结果去和后端比对时,没有先确认对方使用的时区规则。

FAQ

如果我完全不知道这个数字是秒还是毫秒,怎么办?

最简单的办法就是两种模式各试一次,看哪个转换出的日期落在合理区间。

为什么毫秒模式转换到日期时间后没有保留后三位?

因为当前页面显示的是格式化后的可读时间字符串,不是带毫秒的小数展示。

这个页面适合查 UTC 吗?

适合做快速核对,但它的日期时间输入和显示更偏浏览器本地环境,所以如果你在排 UTC,仍要先确认上下文。

适合用于后端排错吗?

很适合做第一轮核对,尤其是确认秒/毫秒和本地/UTC 假设时会很高效。

说明与限制

这个工具最适合开发调试和格式确认,不适合替代带完整时区标记、子秒精度和明确 UTC 语义的专业工具。

和后端、数据库或第三方 API 对接时,最好先把三件事确认清楚:对方到底用秒还是毫秒、日期时间按 UTC 还是本地解释、以及是否保留毫秒以下精度。当前页面能帮你快速排第一层问题,但不会自动推断这些上下文约定。

常见问题

这个工具最容易出错的地方是什么?

最常见的问题是把秒和毫秒混淆,或者误以为日期时间输入框天然代表 UTC。

秒和毫秒模式会同时影响两个方向吗?

会。当前选择的单位既影响“时间戳转日期时间”,也影响“日期时间转时间戳”。

为什么页面不用自动转换?

因为当前页面把两个方向拆成独立按钮,方便你明确自己这次到底是想读时间戳还是想生时间戳。

结果里的日期时间使用哪个时区?

当前页面按浏览器本地环境解释 datetime-local 输入,结果也没有额外附加时区标签。