如何在单元测试中断言当前本地日期-java教程-PHP中文网

如何在单元测试中断言当前本地日期

本文介绍在Java单元测试中正确断言“当前本地日期”的实践方法，重点解决使用过时的java.util.Date API导致的断言失效问题，并推荐基于java.time.LocalDate的现代、线程安全且语义清晰的替代方案。

本文介绍在java单元测试中正确断言“当前本地日期”的实践方法，重点解决使用过时的`java.util.date` api导致的断言失效问题，并推荐基于`java.time.localdate`的现代、线程安全且语义清晰的替代方案。

在编写日期相关断言时，常见误区是直接使用 java.util.Date 的 getDate() 方法（如 crDate.getDate()），该方法返回的是月份中的日（1–31），而非完整日期对象，且已自 Java 1.1 起被标记为 @Deprecated。更严重的是，Date.getDate() 无法表达“今日”这一业务语义——它仅提取日字段，丢失年、月信息，极易造成断言逻辑错误（例如：1月31日与3月31日均返回 31，但显然不等价）。

✅ 正确做法是采用 java.time 包中的 LocalDate.now()：

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;
import java.time.LocalDate;

@Test
void testRefDateIsToday() {
    // 假设 S55.jsonPath().getString("details.ref") 返回形如 "2024-06-12" 的 ISO 格式字符串
    String refDateString = S55.jsonPath().getString("details.ref");
    LocalDate refDate = LocalDate.parse(refDateString);

    // 断言：refDate 必须等于系统默认时区下的今日日期
    assertEquals(LocalDate.now(), refDate);
}

⚠️ 注意事项：

避免混用旧API：不要调用 new Date().getDate() 或 Calendar.get(Calendar.DAY_OF_MONTH)，它们无法表示完整日期，也不支持不可变性与时区显式控制。
确保格式一致：若接口返回的是字符串（如 JSON 中的 "2024-06-12"），务必用 LocalDate.parse() 解析；若返回的是毫秒时间戳或 Instant，需先转换：Instant.ofEpochMilli(timestamp).atZone(ZoneId.systemDefault()).toLocalDate()。

测试可重复性（进阶）：若需控制“今天”以提升测试稳定性（如避免跨日失败），可通过依赖注入 Clock 实现可插拔时间源：

// 生产代码中
public class Service {
    private final Clock clock;
    public Service(Clock clock) { this.clock = clock; }
    public LocalDate getToday() { return LocalDate.now(clock); }
}
// 测试中
Clock fixedClock = Clock.fixed(Instant.parse("2024-06-12T00:00:00Z"), ZoneId.systemDefault());
assertEquals(LocalDate.of(2024, 6, 12), service.getToday());

总结：LocalDate.now() 是断言“当前本地日期”的标准、简洁且可靠的方案。它语义明确、线程安全、无需手动格式化或字段提取，完美契合测试场景中对“今日”这一业务概念的验证需求。请立即弃用 Date.getDate() 等遗留方式，拥抱 java.time。