推荐使用Java 8+的LocalDate与ChronoUnit.DAYS.between计算日期天数差，线程安全、语义清晰；带时间场景优先用Instant或Duration；避免过时的Date/Calendar。
Java 中计算两个日期之间相差天数，推荐使用 Java 8+ 的 java.time API（如 LocalDate、ChronoUnit），它线程安全、语义清晰、不易出错。避免使用已过时的 Date 和 Calendar。
用 LocalDate + ChronoUnit 计算纯日期差（忽略时分秒）
适用于只关心“年月日”的场景（例如生日间隔、项目周期天数）：
- 将日期解析为
LocalDate（自动截断时间部分） - 用
ChronoUnit.DAYS.between(earlier, later)直接获取天数差（结果可为负，注意参数顺序）
示例：
LocalDate start = LocalDate.of(2023, 1, 15); LocalDate end = LocalDate.of(2023, 2, 10); long days = ChronoUnit.DAYS.between(start, end); // 结果：26
处理带时间的日期（Instant / LocalDateTime）
若原始数据含具体时刻（如数据库中的 timestamp），需明确是否要“按自然日”还是“精确到毫秒”：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 用
Instant计算毫秒差再转天数（向下取整）：(end.toInstant().toEpochMilli() - start.toInstant().toEpochMilli()) / (24L * 60 * 60 * 1000) - 更推荐用
Duration或Period：Duration.between(start.atStartOfDay(), end.atStartOfDay()).toDays()—— 强制按“当天 00:00”对齐，等效于LocalDate方式
兼容旧代码：SimpleDateFormat + Calendar（不推荐，仅应急）
如果必须维护老项目，注意以下陷阱：
-
SimpleDateFormat非线程安全，每次使用应新建实例或加锁 -
Calendar的月份从 0 开始（Jan=0），易错 - 需手动归零时分秒，否则可能因时间部分导致差值多/少 1 天
简单示例（仅作参考）：
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
Date d1 = sdf.parse("2023-01-15");
Date d2 = sdf.parse("2023-02-10");
long diff = (d2.getTime() - d1.getTime()) / (24L * 60 * 60 * 1000); // 26注意事项与常见问题
- 结果是“日历天数差”，不是工作日；如需排除周末/节假日，需额外逻辑（如用
TemporalAdjusters或第三方库如 Time4J） -
ChronoUnit.DAYS.between返回的是“完整天数”，即2023-01-01到2023-01-02是 1 天，不是 2 - 时区敏感：跨时区比较建议统一转为
Instant或指定时区的ZonedDateTime
