Instant 是基于 UTC 的纳秒级时间戳，表示自 1970-01-01T00:00:00Z 起的瞬时点，无时区依赖、无夏令时干扰，适合系统间统一时间标记；常用操作包括 Instant.now() 获取当前时刻、toEpochMilli() 转毫秒时间戳、atZone() 转换时区显示。

Instant 生成的时间戳是 UTC 时区下的纳秒级精确值，直接对应 Unix 时间戳（秒数），但默认不带时区信息，需注意格式化与传输场景的处理。

Instant 是什么？为什么适合做时间戳

Instant 表示时间线上的一个瞬时点，基于 UTC（协调世界时），底层用自 1970-01-01T00:00:00Z 起的纳秒数存储。它不依赖本地时区，没有夏令时干扰，天生适合做系统间统一的时间标记。

• 创建当前时刻： Instant.now() —— 精确到纳秒（取决于系统时钟精度）
• 从毫秒构造： Instant.ofEpochMilli(1717023600000L)
• 从秒+纳秒构造： Instant.ofEpochSecond(1717023600, 123000000)（第123百万纳秒）

如何转成常用时间戳格式

所谓“时间戳”，实际常指不同精度的整数表示。Instant 提供了便捷转换方法：

• 秒级时间戳（Long）：instant.getEpochSecond()
• 毫秒级时间戳（Long）：instant.toEpochMilli()（最常用，兼容老系统）
• 微秒/纳秒级需自行计算：instant.getEpochSecond() * 1_000_000_000 + instant.getNano()

⚠️ 注意：toEpochMilli() 是截断而非四舍五入，比如纳秒为 999_499_999 时仍转为前一个毫秒值。

序列化与 JSON 传输的常见坑

Instant 默认 toString() 输出 ISO-8601 格式（如 2024-05-30T08:20:00.123Z），但很多框架（如 Jackson）会自动转成长整型毫秒值或字符串，行为不一致易出错。

Yys Wallpaper

阴阳师原画壁纸下载工具，自动从指定页面抓取壁纸，按分辨率保存至 ~/图片/{分辨率}/，跳过已有文件。触发条件：用户需要下载、整理或批量获取阴阳师壁纸。

下载

• 显式控制 Jackson 序列化：加注解 @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss.SSS") 或配置 SerializationFeature.WRITE_DATES_AS_TIMESTAMPS = false
• 数据库存取：JDBC 4.2+ 支持 PreparedStatement.setObject(idx, instant)，推荐直接存 Instant，别手动转 long
• 日志打印建议用 instant.toString()，可读性强且无时区歧义

和 LocalDateTime、ZonedDateTime 的关键区别

Instant 不代表“几点几分”，它只是时间轴坐标。想转成本地时间显示，必须通过 ZoneId 显式转换：

• instant.atZone(ZoneId.systemDefault()) → 带时区的 ZonedDateTime
• instant.atZone(ZoneId.of("Asia/Shanghai")) → 指定时区
• instant.atZone(ZoneId.of("UTC")).toLocalDateTime() → 强制按 UTC 解释再转成本地“挂钟时间”（不推荐，易混淆）

❌ 错误做法：LocalDateTime.now() 直接当时间戳用 —— 它没时区，跨机器可能含义完全不同。

基本上就这些。用 Instant 记录时间戳，核心就三点：用 now() 获取、用 toEpochMilli() 对齐旧系统、用 atZone() 再做展示。不复杂但容易忽略时区语义。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南