使用Joda Time计算Java日期差为何出现天数差异？

问题复现 #

使用Joda Time的以下代码计算日期间隔：

Period period = new Period(startDate, endDate, PeriodType.yearMonthDay());

int years = period.getYears();
int months = period.getMonths();
int days = period.getDays();

两种测试场景的结果：

• 当startDate = 1975-05-01、endDate = 2024-04-05时：years=48, months=11, days=4（符合预期）
• 当startDate = 1975-04-30、endDate = 2024-04-05时：years=48, months=11, days=6（预期天数为5，不符合直觉）

原因解析 #

Joda Time的yearMonthDay()类型是按年→月→日的层级顺序计算差值，不是直接计算绝对天数差：

1. 第一个场景：1975-05-01 → 2023-05-01（48年）→ 2024-04-01（11个月）→ 2024-04-05与2024-04-01的天数差为4，结果正常。
2. 第二个场景：1975-04-30 → 2023-04-30（48年）→ 加11个月时，由于3月没有30日，自动调整为2024-03-30 → 2024-04-05与2024-03-30的天数差为6，这就是结果不符合预期的核心原因。

解决方案 #

根据生日计算的场景需求，可选择以下方式处理：

1. 计算绝对天数差

如果只需要两个日期的实际间隔天数，直接用Days类：

Days dayDiff = Days.daysBetween(startDate, endDate);
int days = dayDiff.getDays();

此方式会得到准确的绝对天数差，比如1975-04-30到2024-04-05的差值为17876天。

2. 适配生日场景的层级计算

要保留年、月、日的展示逻辑，同时符合生日计算直觉，可先将起始日期的年份对齐到结束年份，再调整计算：

LocalDate adjustedStart = startDate.withYear(endDate.getYear());
Period period;
if (adjustedStart.isAfter(endDate)) {
    adjustedStart = adjustedStart.minusYears(1);
    period = new Period(adjustedStart, endDate, PeriodType.yearMonthDay());
    period = period.plusYears(1);
} else {
    period = new Period(adjustedStart, endDate, PeriodType.yearMonthDay());
}

如果是计算距离下一次生日的天数，可反向计算：

LocalDate nextBirthday = startDate.withYear(endDate.getYear());
if (nextBirthday.isBefore(endDate)) {
    nextBirthday = nextBirthday.plusYears(1);
}
Days daysToBirthday = Days.daysBetween(endDate, nextBirthday);

3. 迁移到Java 8+的java.time库

Joda Time已进入维护阶段，推荐使用原生java.time API，其日期计算逻辑更清晰：

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

LocalDate start = LocalDate.of(1975, 4, 30);
LocalDate end = LocalDate.of(2024, 4, 5);

// 层级间隔
Period period = Period.between(start, end);
// 绝对天数差
long dayDiff = ChronoUnit.DAYS.between(start, end);

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