java时间戳转换日期格式14位：先分清秒与毫秒
有人拿到一串14位数字，想把它转成日期，结果在Java里格式化出来却是1970年。问题往往不在格式化代码，而在于这串数字到底代表秒还是毫秒。这篇教程从实际输入出发，帮你判断位数含义、选对转换方式，并处理负数与边界值。
在线工具时间戳转换
14位数字不一定是毫秒时间戳
看到“java时间戳转换日期格式14位”这个说法，很多人默认14位就是毫秒级时间戳。实际并非如此：14位也可能被理解为日期字符串，比如年月日时分秒拼在一起的样子。所以第一步不是写代码，而是确认手里的值来源。
如果值来自数据库的秒级字段，它就是秒；如果来自 System.currentTimeMillis()，它就是毫秒。把秒当毫秒处理，日期会落在1970年前后；把毫秒当秒处理，结果会跑到很远的未来。先用小值验证思路：输入 14，得到的是 1970-01-01 00:00:14，说明这里按秒解释；输入 13 和 15，分别对应 00:00:13 与 00:00:15，规律一致。
确认单位后，再决定用 Instant、LocalDateTime 还是 Date 来承接。单位错了，后面所有格式化都是白费。
用秒级数值走一遍转换流程
假设你已经确认是秒级时间戳，可以按下面的顺序操作。
- 先把原始值读成 long，避免字符串拼接时丢失精度。
- 用 Instant.ofEpochSecond(value) 得到时刻对象，这一步明确告诉代码“这是秒”。
- 需要本地时间时，再通过 atZone 指定时区，不要依赖机器默认时区。
- 最后用 DateTimeFormatter 输出你要的格式，例如 yyyy-MM-dd HH:mm:ss。
拿 3614 试一下：按秒解释是 1970-01-01 01:00:14；拿 674 试，是 1970-01-01 00:11:14。两个值相差 2940，输出的时分秒也正好对应这个差值，说明秒级解释是自洽的。
如果你只是想快速核对结果，可以借助时间戳转换对照输出，再回到代码里调整单位。
毫秒与负数的处理细节
毫秒级时间戳要用 Instant.ofEpochMilli，别和 ofEpochSecond 混用。同一个数字 14，按毫秒解释是 14000 毫秒，也就是 1970-01-01T00:00:14.000Z，和按秒解释的秒数相同但含义不同，代码里必须写清楚。
负数更容易出错。输入 -646，按秒解释得到 1969-12-31 23:49:14；输入 -3586，得到 1969-12-31 23:00:14。负数表示1970年之前的时间，格式化时如果只取绝对值或用了无符号解析，结果就会错位。读值时用 long 而不是 int，也能避免大数值溢出。
另外，格式化器里的时区要和业务约定一致。同一时刻在 UTC 和东八区显示的小时数不同，排查时先打印 Instant，再打印带时区的结果，逐层对比。
常见错误与排查顺序
格式化结果不对，按这个顺序查通常最快：先看原始值的单位，再看解析方法是否匹配，然后看时区，最后看格式串。格式串里 yyyy 和 YYYY 含义不同，HH 与 hh 也不一样，写错一个字母就可能出现跨年或上下午错位。
还有一种情况是值本身不是时间戳，而是被截断的日期数字。遇到这种输入，不要硬套转换函数，先回到数据源头确认语义。相关概念可以对照c11时间戳转换日期格式：结果与校验里的校验思路，把输入输出成对记录下来，方便复现。
排查时保留中间结果：原始 long、Instant、带时区的 ZonedDateTime、最终字符串。四层都打印出来，问题出在哪一层一目了然。
总结
处理这类转换，关键顺序是：确认原始值的单位，选对 ofEpochSecond 或 ofEpochMilli，指定明确时区，再用格式串输出。遇到异常先打印中间对象，负数和大值用long承接，格式串逐字母核对。把这几步固定下来，java时间戳转换日期格式14位这类问题就能稳定定位。
相关文章
- 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时间戳转换成时间6：从参数6看懂秒级换算
以参数6为例，讲清Java时间戳换算成时间的思路：秒与毫秒的区别、UTC与本地时区、边界值与常见报错排查。
- java时间戳转换差了20个小时：从现象到修复的完整教程
遇到java时间戳转换差了20个小时？本教程从现象出发，教你用工具验证时间戳、定位时区与单位问题，并给出修复步骤。
常见问题
Q114位数字按秒转换后为什么是1970年？
因为秒级时间戳的起点就是1970年，14秒对应的正是1970-01-01 00:00:14。如果你期望的是近期日期，说明这个值大概率是毫秒或另有含义，需要回到数据来源确认单位。
Q2同一个数字按秒和按毫秒结果差多少？
按秒解释时 14 表示1970-01-01 00:00:14；按毫秒解释时 14 表示14000毫秒，同样落在1970-01-01T00:00:14.000Z。数值小的时候看起来接近，数值大时差距会非常明显，所以必须先定单位。
Q3负值时间戳格式化后日期不对怎么办？
负值代表1970年之前，例如 -646 对应1969-12-31 23:49:14。检查读值类型是否为long，解析时是否误用了无符号方法，以及时区设置是否一致。
Q4格式串写对了吗？
常见问题是把 yyyy 写成 YYYY，或把 HH 写成 hh。前者涉及周年，后者涉及12小时制。先用一个已知值输出完整结果，再逐项核对格式串。