[toc]

428. Java 日期时间 API - Instant “时间原子钟”

1. 什么是 Instant？

• Instant 表示 时间线上的一个精确点。
• 从 1970-01-01T00:00:00Z（UTC 时间）作为起点（EPOCH）。
• 可以理解为：
  • 人类说“2025年9月15日 14:30 北京时间”。
  • 机器说“从 EPOCH 起过了 X 秒 Y 纳秒”。

👉 所以，Instant 更像是 机器时间戳，非常适合日志、监控、分布式系统中做时间标记。

2. 基本用法

获取当前时间戳：

import java.time.*;

public class InstantDemo {
    public static void main(String[] args) {
        Instant timestamp = Instant.now();
        System.out.println("Now: " + timestamp);
    }
}

输出示例：

Now: 2025-09-15T06:35:42.123Z

• Z 代表 Zulu time（即 UTC 时间）。
• 不带时区偏移量，统一标准。

3. EPOCH 与偏移

• Instant 以 EPOCH（1970-01-01T00:00:00Z）为起点计时。
• 早于 EPOCH 的时间 → 负数。
• 晚于 EPOCH 的时间 → 正数。

Instant epoch = Instant.ofEpochSecond(0);
Instant now = Instant.now();
long seconds = epoch.until(now, java.time.temporal.ChronoUnit.SECONDS);

System.out.println("Seconds since EPOCH: " + seconds);

输出：

Seconds since EPOCH: 1757912142

🎯 很像 System.currentTimeMillis()，但 Instant 精度更高（纳秒级）。

4. 操作 Instant

Instant 不能直接用年月日加减，但可以用 时间单位（ChronoUnit）：

Instant now = Instant.now();
Instant oneHourLater = now.plus(1, ChronoUnit.HOURS);

System.out.println("Now:          " + now);
System.out.println("One hour later: " + oneHourLater);

比较方法：

Instant t1 = Instant.now();
Instant t2 = t1.plusSeconds(10);

System.out.println(t2.isAfter(t1));  // true
System.out.println(t1.isBefore(t2)); // true

5. Instant 与人类时间的桥梁 🌍

⚠️ Instant 本身不懂 “几月几号”。
如果要转成人类可读的日期，需要 绑定时区，转成 LocalDateTime 或 ZonedDateTime：

Instant timestamp = Instant.now();

// 转换到系统默认时区（比如 Asia/Shanghai）
LocalDateTime ldt = LocalDateTime.ofInstant(timestamp, ZoneId.systemDefault());

System.out.printf("%s %d %d at %d:%d%n",
        ldt.getMonth(), ldt.getDayOfMonth(),
        ldt.getYear(), ldt.getHour(), ldt.getMinute());

输出：

SEPTEMBER 15 2025 at 14:35

🎯 常见场景：

• 日志存储：用 Instant 保证统一的 UTC 时间。
• 展示给用户：再转成带时区的 ZonedDateTime，显示本地时间。

6. Instant 的边界值

• Instant.MIN → 最早可表示的时间。
• Instant.MAX → 最晚可表示的时间。
  ⚠️ 不常用，但有时做边界测试会用到。

7. 总结

💡 记住：

• 存储/传输 → Instant（统一 UTC）
• 展示/交互 → 转换成 LocalDateTime 或 ZonedDateTime