java13位时间戳转换代码的正确写法

先固定输入约定，别让单位混进来

Java 的 Instant.ofEpochMilli 接收毫秒值，因此入口参数应明确为毫秒时间戳，不能把秒值不加区分地传入。建议在方法名称、字段注释和接口文档中直接写明 epochMillis，比笼统的 timestamp 更容易排查问题。

证据样例中，Unix 秒值 13 对应毫秒值 13000，ISO 表示为 1970-01-01T00:00:13.000Z。这个样例适合验证单位差异，但它本身并不是固定长度的毫秒输入。接入业务数据前，可先用时间戳转换工具核对原始值的单位和预期日期，再确定代码入口。

把毫秒值转换成可读日期

准备好原始字符串和目标时区后，先清理首尾空白，再校验格式；校验通过后解析为 long，随后构造 Instant 并格式化。每个动作按依赖顺序执行，避免解析失败后仍继续转换。

```javaimport java.time.Instant;import java.time.ZoneId;import java.time.format.DateTimeFormatter;import java.util.Locale;

public final class TimestampConverter {private static final DateTimeFormatter FORMATTER =DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm:ss.SSS").withLocale(Locale.ROOT);

private TimestampConverter() {}

public static String formatMillis(String raw, ZoneId zone) {if (raw == null) {throw new IllegalArgumentException("时间戳不能为空");}

String value = raw.trim();if (!value.matches("-?\\d{13}")) {throw new IllegalArgumentException("时间戳格式不符合约定");}

long epochMillis = Long.parseLong(value);Instant instant = Instant.ofEpochMilli(epochMillis);return FORMATTER.withZone(zone).format(instant);}}```

方法要求调用方显式传入 ZoneId。这样，同一时间点采用哪个地区的日期规则，由业务层决定，而不是悄悄依赖服务器环境。

想保留标准时间表达时，不要先转本地日期

如果结果要写入日志、跨系统传递或参与接口签名，通常可以直接保留 Instant 的标准字符串。它表达的是明确时间点，不夹带服务器默认时区。

```javaimport java.time.Instant;import java.time.format.DateTimeFormatter;

public static String toIsoText(String raw) {long epochMillis = Long.parseLong(raw.trim());Instant instant = Instant.ofEpochMilli(epochMillis);return DateTimeFormatter.ISO_INSTANT.format(instant);}```

只有展示给用户时，再按照页面或账户配置的 ZoneId 转成本地日期。若开发机显示正常、部署后却出现偏差，优先检查是否调用了系统默认时区，以及运行环境的时区配置是否一致。

报错或日期异常时按输入链路排查

看到日期接近 1970年，先确认上游给的是秒还是毫秒。单位认错时，代码可能不抛异常，却会得到明显不符合业务预期的日期。

遇到 NumberFormatException，检查字符串中是否含小数点、空格以外的字符或字段包装符。trim 只能处理首尾空白，不能修复格式错误。遇到 null 或空文本，应在解析前返回清晰的业务错误，不要让异常停留在底层转换调用。

负值并不必然是非法数据。证据样例中的 -3587 秒对应 1969-12-31T23:00:13.000Z，说明纪元之前的时间可以用负值表达。是否允许这类输入，应由业务日期范围决定，而不是简单按正负号拦截。

反向转换时必须补齐时区

从日期文本转回毫秒值时，本地日期本身没有完整的时间点含义，必须结合时区解释。操作顺序是：先按固定格式解析文本，再绑定业务时区，接着转换为 Instant，最后取得毫秒值。

```javaimport java.time.LocalDateTime;import java.time.ZoneId;import java.time.format.DateTimeFormatter;

public static long toEpochMillis(String text, ZoneId zone) {DateTimeFormatter formatter =DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm:ss.SSS");LocalDateTime localDateTime = LocalDateTime.parse(text, formatter);return localDateTime.atZone(zone).toInstant().toEpochMilli();}```

测试时应同时检查正值、负值、格式错误和不同时区。正向格式化后再反向解析，也要使用相同格式与相同时区，否则得到的毫秒值可能不同。

相关文章

• 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与本地时区、边界值与常见报错排查。

常见问题