本文介绍如何准确判断两个 LocalDateTime 之间的日期差是否 ≥ 1 年，推荐使用现代 Java Time API（Period.between()）替代易出错的 Calendar + 手动天数计算，避免闰年、时区、精度等陷阱。
本文介绍如何准确判断两个 localdatetime 之间的日期差是否 ≥ 1 年，推荐使用现代 java time api（`period.between()`）替代易出错的 `calendar` + 手动天数计算，避免闰年、时区、精度等陷阱。
在 Java 中，简单用“365 天”或“366 天”阈值判断是否满一年，本质上是语义错误：一年的长度取决于具体起止年份（是否含闰年）、月份天数（如 2 月 vs 7 月），更关键的是——“满一年”是日历意义上的概念（年/月/日对齐），而非固定毫秒或天数。原始代码中通过 Calendar 计算毫秒差再转为天数，并粗略加 1 天处理闰年，存在多重缺陷：
- ❌ 忽略月份和日期的相对位置（例如
2022-02-28到2023-02-27不足一年，但按 365 天计算可能误判）； - ❌
isLeapYear()的调用逻辑有误（仅检查单一年份无法决定跨年区间是否含闰日）； - ❌
TimeUnit.MICROSECONDS.toDays()实际应为TimeUnit.MILLISECONDS.toDays()，且会截断小数天，导致精度丢失； - ❌
GregorianCalendar实例被声明为实例字段却在静态main中调用非静态方法，编译不通过。
✅ 正确做法是使用 java.time 包中的 Period ——它专为日历单位（年、月、日）的差值设计，语义清晰、线程安全、无需手动处理闰年。
以下为完整可运行示例：
import java.time.LocalDateTime;
import java.time.Period;
import java.time.format.DateTimeFormatter;
public class DateOneYearDifferenceTest {
public static void main(String[] args) {
// 输入字符串（支持毫秒）
String dateStrA = "2022-08-20 10:26:44.000";
String dateStrB = "2023-08-25 10:26:44.000";
// 定义解析格式：uuuu=四位年份，SSS=三位毫秒
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm:ss.SSS");
// 解析为 LocalDateTime（不含时区）
LocalDateTime ldtA = LocalDateTime.parse(dateStrA, formatter);
LocalDateTime ldtB = LocalDateTime.parse(dateStrB, formatter);
// 计算日历意义上的日期差（忽略时分秒，仅比较年月日）
Period period = Period.between(ldtA.toLocalDate(), ldtB.toLocalDate());
// 判断是否 ≥ 1 整年（注意：Period.getYears() 返回的是完整年数，不包含不足一年的余量）
boolean isMoreThanOneYear = period.getYears() >= 1;
System.out.println("Difference ≥ 1 year? " + isMoreThanOneYear); // true
}
}
? 关键说明：
-
Period.between()基于日历算法计算：它会逐级比较年→月→日，例如2022-08-20到2023-08-19返回P0Y11M30D（0 年），而到2023-08-20才返回P1Y0M0D； - 若需考虑时间部分（时/分/秒/毫秒），应先判断
Period是否 ≥1 年；若恰好等于 1 年（getYears() == 1 && getMonths() == 0 && getDays() == 0），再用Duration.between()比较时间偏移； -
LocalDateTime适用于无时区场景；若涉及跨时区业务，请改用ZonedDateTime并统一时区后再转换为LocalDate。
? 总结建议：
永远优先使用 java.time（Java 8+）替代过时的 Calendar 和 Date；Period 用于“日历年月日”差，Duration 用于“精确时间跨度”差；避免以固定天数（365/366）作为一年的判定标准——它只在特定上下文（如金融天数计算）中成立，而非通用日历逻辑。
