关于ChronoUnit.MONTHS的addTo()与between()行为不一致的技术问询

这不是Bug，而是两个方法遵循了不同的日期运算规则，相关逻辑在Java官方文档中均有明确说明，只是容易被忽略。

1. addTo/plusMonths的行为逻辑 #

ChronoUnit.MONTHS.addTo() 和 OffsetDateTime.plusMonths() 采用**“有效日期优先”**规则：当目标月份没有与原日期对应的天数时（比如1月31日加1个月，2月没有31日），会自动将日期调整为目标月份的最后一天。

示例代码中的行为完全符合规则：

var d1 = OffsetDateTime.parse("2023-01-31T10:00:00Z");
var d2 = ChronoUnit.MONTHS.addTo(d1, 1); // 结果为2023-02-28T10:00:00Z

2. between的行为逻辑 #

ChronoUnit.MONTHS.between() 计算的是**“完整的日历月数”**，核心规则是：只有当结束日期的「日时分秒」大于等于开始日期的「日时分秒」时，才算经过了一个完整的日历月。

以你的案例为例：

d2 = ChronoUnit.HOURS.addTo(d2, 23); // 结果为2023-03-01T09:00:00Z
System.out.println(ChronoUnit.MONTHS.between(d1, d2)); // 输出0

这里d2的时间是3月1日09:00，早于d1的10:00，不满足“完整一个月”的条件——只有当时间到达2023-03-01T10:00:00Z时，between才会返回1。

3. 反直觉案例的解释 #

针对你提到的两个场景：

• 场景1：2023-01-31 11:00 到 2023-03-01 10:00 之间的between返回0。原因是结束时间（3月1日10:00）早于开始时间的对应时刻（3月1日11:00），未完成一个完整的日历月周期。
• 场景2：2023-05-31 11:00 到 2023-12-01 10:00 之间的between返回5。因为从5月31日11:00开始，每经过一个完整月的节点依次是6月30日11:00、7月31日11:00、8月31日11:00、9月30日11:00、10月31日11:00，共5个完整周期；而12月1日10:00还未到达第6个周期的节点（11月30日11:00加1个月应为12月30日11:00），因此返回5。而plusMonths(6)得到2023-11-30 11:00，是因为11月没有31日，被调整到当月最后一天，这是addTo规则的正常结果。

总结 #

这两个方法的设计目标不同：

• addTo/plusMonths用于日期偏移，优先保证结果是合法有效的日期；
• between用于统计两个日期之间的完整单位数量，严格遵循“完整周期”的定义。

如果需要让偏移后的日期与原日期的间隔计算逻辑一致，可以结合TemporalAdjusters手动调整日期（比如统一调整到每月第一天或最后一天），或者使用Period类进行更灵活的周期计算。

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