java实现13位时间戳转换：从毫秒到可读时间

先分清13位时间戳到底代表什么

13位时间戳通常指Unix时间戳的毫秒表示，也就是从1970-01-01T00:00:00Z起算的毫秒数。比如输入13，对应的毫秒值是13000，ISO格式为1970-01-01T00:00:13.000Z。Java里处理时间有两个常见入口：老的java.util.Date和新的java.time.Instant。前者以毫秒为核心，后者支持纳秒精度但常从毫秒构造。选哪个取决于你的项目JDK版本和已有代码风格。如果只是把一串数字转成可读字符串，Instant配合DateTimeFormatter更直接；如果代码里到处是Date，用Date构造再格式化也不绕。

用Instant和Date完成基本转换

以13位时间戳为例，第一步是把它读成long类型，避免用int导致溢出。第二步，如果使用Instant，调用Instant.ofEpochMilli(13000L)得到时刻对象；如果使用Date，直接new Date(13000L)。第三步，格式化输出。Instant可以配合DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(ZoneOffset.UTC)得到UTC时间字符串，结果与1970-01-01 00:00:13对应。Date则通常配合SimpleDateFormat，但要注意SimpleDateFormat不是线程安全的，多线程环境下每次新建实例或改用DateTimeFormatter。需要快速核对转换结果时，可以借助本站的时间戳转换工具输入数值对照ISO输出。

时区处理：为什么你的结果和预期差几小时

很多人把13位时间戳转成Date再打印，发现时间不是00:00:13而是08:00:13，原因在于Date的toString和SimpleDateFormat默认使用JVM时区。时间戳本身是绝对时刻，不带时区信息。要得到UTC结果，格式化时显式指定ZoneOffset.UTC；要得到本地时间，用ZoneId.systemDefault()。Instant.toString()始终输出UTC的ISO格式，这也是它不容易出错的地方。如果业务要求展示北京时间，就在formatter里withZone(ZoneId.of("Asia/Shanghai"))，不要依赖服务器默认时区，否则部署环境一换结果就变。

常见错误与排查思路

第一个高频错误是把13位时间戳当秒用，直接传给需要秒的API，结果日期跑到1970年附近。判断方法很简单：13位数值的量级对应毫秒，转换前先确认来源字段的单位。第二个错误是用int接收，13位数值超出int范围时会截断，必须用long。第三个错误是格式化模式写错，比如把MM和mm混用，导致月份和分钟颠倒。排查时先把时间戳单独打印出来，再用Instant.ofEpochMilli转成ISO字符串比对，确认是数值问题还是格式化问题。对于负值时间戳，比如-3587对应1969-12-31T23:00:13.000Z，逻辑同样成立，不要假设时间戳一定为正。

进阶：在转换中保留毫秒与处理边界

有些场景需要保留毫秒部分，比如日志时间线对齐。Instant本身支持毫秒，格式化时加上SSS即可输出毫秒段。如果只需要秒级精度，可以用instant.getEpochSecond()取秒，但注意这会丢掉毫秒信息。另一个边界是时间戳为0的情况，对应1970-01-01T00:00:00Z，转换逻辑不应把它当成空值。对于从数据库或接口拿到的字符串形式时间戳，先用Long.parseLong解析，捕获NumberFormatException并给出明确提示，比让异常直接抛到上层更容易定位。需要理解13位时间戳在字符串形态下的转换细节，可以参考13位时间戳转换string的解析中的说明。

相关文章

• jq13位时间戳转换成日期：参数结果核对

  说明参数13按Unix秒转换后的UTC日期，并区分数值13与13位毫秒时间戳。

• jq12位时间戳转换成日期：12 对应哪一刻？

  参数 12 按 Unix 时间戳换算，对应 1970-01-01 00:00:12（UTC），毫秒数为 12000。本文说明结果含义、换算步骤与相邻参数对照。

• jdk8将时间戳转换成instant：8秒的转换结果

  在JDK8中把时间戳8转换为Instant，结果是1970-01-01T00:00:08Z，对应UTC时间00:00:08，毫秒值8000。

• java时间戳转换日期格式14位：先分清秒与毫秒

  从14位时间戳的位数困惑讲起，用实例说明秒与毫秒的差别，并给出Java格式化日期与排查错误的做法。

• java时间戳转换成时间6：从参数6看懂秒级换算

  以参数6为例，讲清Java时间戳换算成时间的思路：秒与毫秒的区别、UTC与本地时区、边界值与常见报错排查。

常见问题