java单元测试中应通过注入java.time.clock实例替代硬编码system.currenttimemillis()或localdatetime.now()，支持固定时间、偏移时间和手动推进等模拟方式，并注意时区与instant的一致性。
在 Java 单元测试中模拟当前时间，核心是避免直接调用 System.currentTimeMillis() 或 LocalDateTime.now() 这类依赖系统时钟的静态方法，而是通过可注入、可替换的 Clock 实例来统一控制时间源。
使用 java.time.Clock 作为时间抽象
Clock 是 Java 8 引入的时间抽象类，提供了获取当前时刻（instant()）、毫秒数（millis()）和时区（getZone()）等能力。它默认实现（如 Clock.systemDefaultZone()）依赖真实系统时钟；但你可以轻松替换成固定时间或可偏移的模拟时钟。
-
固定时间：用
Clock.fixed(Instant.parse("2024-01-01T12:00:00Z"), ZoneId.of("UTC"))模拟某个确定时刻 -
可偏移时间：用
Clock.offset(baseClock, Duration.ofHours(2))基于某时钟做偏移 -
手动推进时间：配合
Clock.tick(Clock, Duration)可以按指定粒度“跳动”时间（适合测试时间推进逻辑）
将 Clock 注入到被测类中
不要在业务代码里硬编码 LocalDateTime.now()。改为接收一个 Clock 实例（构造函数注入或 setter 注入），并在内部用它获取时间：
public class OrderService {
private final Clock clock;
public OrderService(Clock clock) {
this.clock = clock;
}
public LocalDateTime createOrderTime() {
return LocalDateTime.now(clock); // ✅ 使用注入的 Clock
}
}
测试时传入模拟 Clock，生产环境传入 Clock.systemDefaultZone() 即可。
在测试中灵活配置模拟 Clock
JUnit 5 + Mockito 场景下，常见做法是直接 new 一个固定 Clock：
@Test
void shouldReturnFixedOrderTime() {
Clock fixedClock = Clock.fixed(Instant.parse("2024-01-01T10:00:00Z"), ZoneId.of("Asia/Shanghai"));
OrderService service = new OrderService(fixedClock);
LocalDateTime time = service.createOrderTime();
assertThat(time).isEqualTo(LocalDateTime.of(2024, 1, 1, 18, 0)); // UTC+8 → 18:00
}
若类本身不支持注入，可考虑封装一层时间工具类（如 TimeProvider），再对它做 mock —— 但优先推荐 Clock 注入，更轻量、无框架依赖、符合函数式时间建模思想。
注意时区与 Instant 的一致性
Clock 内部基于 Instant（UTC 时间线），所以 LocalDateTime.now(clock) 会根据 clock.getZone() 自动转换。务必确保你创建的 fixed Clock 指定了正确的时区，否则 LocalDateTime 解析结果可能不符合预期。例如：Clock.fixed(Instant.parse("2024-01-01T00:00:00Z"), ZoneId.of("UTC")) 和Clock.fixed(Instant.parse("2024-01-01T00:00:00Z"), ZoneId.of("Asia/Shanghai"))
虽然 Instant 相同，但后者生成的 LocalDateTime 会是 2024-01-01T08:00:00（因 UTC+8）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
