如何获取Java LocalDate日期差的最大整数时间单位（天/月/年）？

已知两个LocalDate实例：

LocalDate date1 = LocalDate.now().minusDays(40);
LocalDate date2 = LocalDate.now();

需要找出能表示两者差值的最大时间单位（从年、月、天中选择），并获取对应整数值。

原方案的问题 #

你原本想用Duration类处理，但Duration是用于计算时分秒等时间维度的时长，不适合处理LocalDate之间的日期差。处理日期差应该用Java.time API中的Period类，它专门用于表示年、月、天组成的日期周期。

原生API实现思路 #

1. 用Period.between()计算两个日期的年、月、天差值
2. 按优先级从大到小检查单位：先看年数是否大于0，再看月数，最后看天数
3. 对应单位有差值时，用ChronoUnit的between()方法直接获取该单位的整数值

代码实现 #

import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;

public class DateDiffCalculator {
    public static long getMaxUnitDiff(LocalDate start, LocalDate end) {
        Period period = Period.between(start, end);
        
        // 优先检查年单位
        int years = period.getYears();
        if (years > 0) {
            return ChronoUnit.YEARS.between(start, end);
        }
        
        // 其次检查月单位
        int months = period.getMonths();
        if (months > 0) {
            return ChronoUnit.MONTHS.between(start, end);
        }
        
        // 最后检查天单位
        long days = ChronoUnit.DAYS.between(start, end);
        if (days > 0) {
            return days;
        }
        
        throw new IllegalArgumentException("两个日期无差值");
    }

    public static void main(String[] args) {
        LocalDate date1 = LocalDate.now().minusDays(40);
        LocalDate date2 = LocalDate.now();
        
        // 示例输出：1（40天约等于1个月）
        System.out.println(getMaxUnitDiff(date1, date2));
    }
}

补充说明 #

• Period.between()会拆解出年、月、天的精确差值，比如40天的差会被拆解为1个月加若干天（具体天数取决于起始日期所在月份的天数）
• ChronoUnit.XXX.between()会直接返回两个日期在对应单位下的整数值，比如MONTHS.between会返回1，因为40天已超过1个自然月

第三方库方案（可选） #

如果需要更灵活的日期差计算，可以使用Apache Commons Lang库中的DateUtils类，但Java原生的Period和ChronoUnit已经能满足需求，无需额外引入依赖。

内容的提问来源于stack exchange，提问作者Tom Carmi