435. Java 日期时间 API - Clock 灵活获取当前时间

435. Java 日期时间 API - Clock 灵活获取当前时间

在 Java 时间 API（java.time 包）中，大多数时间类（例如 LocalDate、LocalDateTime、Instant 等）都有一个静态方法：

• now() ：无参，默认使用 系统时钟 + 系统默认时区。
• now(Clock clock) ：有参，允许你传入一个 Clock 对象，从而控制时间的来源。

👉 换句话说，Clock 就是一个"时间提供者"，它能让你：

• 固定时间（方便测试）
• 切换时区（全球化应用必备）
• 人为调整偏移（模拟未来或过去的时间）

---

1️⃣ 为什么需要 Clock？

在一般代码里，LocalDate.now() 就能拿到今天的日期，那为什么还需要 Clock 呢？

• 测试性更好 如果你写的逻辑依赖于"今天"，那单元测试就很难固定结果。用 Clock.fixed() 就能让测试始终返回一个确定的时间。
• 国际化应用 服务器可能部署在新加坡，但用户在纽约。通过 Clock.system(ZoneId.of("America/New_York"))，你能获取纽约时间。
• 模拟场景 你可能想要测试"10 分钟后会发生什么"，Clock.offset() 可以轻松做到。

---

2️⃣ Clock 的常用工厂方法

0. 系统默认时区（系统时间）

Clock c1 = Clock.systemDefaultZone();
System.out.println("系统默认时区时间: " + Instant.now(c1));

0. UTC 时间

Clock c2 = Clock.systemUTC();
System.out.println("UTC 时间: " + Instant.now(c2));

0. 固定时间（时间静止）

Clock fixedClock = Clock.fixed(Instant.parse("2020-01-01T00:00:00Z"), ZoneId.of("UTC"));
System.out.println("固定时间: " + Instant.now(fixedClock));

👉 输出永远是：

固定时间: 2020-01-01T00:00:00Z

0. 偏移时间（基于某个时钟，加上一个偏移量）

Clock baseClock = Clock.systemUTC();
Clock offsetClock = Clock.offset(baseClock, Duration.ofHours(5));
​
System.out.println("基础 UTC 时间: " + Instant.now(baseClock));
System.out.println("偏移 +5 小时时间: " + Instant.now(offsetClock));

---

3️⃣ 结合 LocalDateTime 使用

很多时间类的 now(Clock) 方法直接支持 Clock，例如：

Clock newYorkClock = Clock.system(ZoneId.of("America/New_York"));
LocalDateTime newYorkTime = LocalDateTime.now(newYorkClock);
​
System.out.println("纽约当前时间: " + newYorkTime);

👉 这样你就能方便地获取全球任意时区的当前时间。

---

4️⃣ 测试场景示例

假设我们写了一个功能： "如果今天是周日，就执行备份" 。 但测试时很难等到周日怎么办？

public class BackupService {
    private final Clock clock;
​
    public BackupService(Clock clock) {
        this.clock = clock;
    }
​
    public boolean shouldBackup() {
        DayOfWeek today = LocalDate.now(clock).getDayOfWeek();
        return today == DayOfWeek.SUNDAY;
    }
}

✅ 测试代码：

// 固定一个"星期天"的时钟
Clock fixedSunday = Clock.fixed(
        LocalDate.of(2025, 9, 14).atStartOfDay(ZoneId.systemDefault()).toInstant(),
        ZoneId.systemDefault()
);
​
BackupService service = new BackupService(fixedSunday);
System.out.println("是否执行备份: " + service.shouldBackup()); // true

👉 这样不用等到真的周日，测试也能通过。

---

🎯 小结

• Clock 是一个抽象类，不能直接 new，只能通过工厂方法获取。

• 常用工厂方法：

  • systemDefaultZone() → 系统时区
  • systemUTC() → UTC 时间
  • fixed() → 固定时间（测试最常用）
  • offset() → 在基础时间上增加偏移

• 在 单元测试 和 多时区应用 中非常有用。

👉 打个比方：

• 不用 Clock = 永远盯着"墙上的时钟"。
• 用了 Clock = 你有一个"随意调节的魔法时钟"，可以暂停、快进、切换时区。