怎么利用 java.time.Period 计算两个日期之间相隔的年、月、日数量-java教程-PHP中文网

Period.between()仅适用于LocalDate，因Period基于日历单位（年/月/日），不支持时分秒；用于LocalDateTime等需先截断为LocalDate，且结果按日历加法反推而非简单数学差值。

怎么利用 java.time.period 计算两个日期之间相隔的年、月、日数量

Period.between() 只能用于 LocalDate，不能直接算 LocalDateTime 或 Instant

很多人试图用 Period.between() 比较两个 LocalDateTime，结果抛出 DateTimeException: Unit must be Years, Months or Days。这是因为 Period 本质是「日历单位」（年/月/日），不包含时分秒维度，而 LocalDateTime 带有时间部分，类型不兼容。

正确做法是先截断到日期粒度：

若你关心的是「日历上的起止日」（比如合同生效日到终止日），用 date1.toLocalDate() 和 date2.toLocalDate() 再调用 Period.between()
若原始数据是 Instant 或带时区的 ZonedDateTime，必须先通过 ZoneId 转成对应时区的 LocalDate，否则跨夏令时或时区偏移会导致日期错位

计算结果依赖「起始日期」，不是简单减法

Period 的年月日是基于日历加法反推的：它找的是「从 start date 加上这个 Period 后最接近 end date 的日期」。这意味着结果不是数学差值，而是语义对齐的结果。

例如：

LocalDate start = LocalDate.of(2023, 1, 31);
LocalDate end   = LocalDate.of(2023, 3, 3);
Period p = Period.between(start, end); // 得到 P1M3D（1个月零3天），不是 P0M31D

原因：2023-01-31 加 1 个月 → 2023-02-28（2月无31日，自动回退到最后一天），再加 3 天 → 2023-03-03。这个逻辑保证了「加回去能复原」，但和直觉的“总天数 ÷ 30”完全不同。

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

不要用 Period 做精确天数统计——该用 ChronoUnit.DAYS.between()
跨月计算时，2月、闰年、大小月都会影响 getMonths() 和
```
 的分配
```

toString() 输出格式固定，解析需谨慎

Period.toString() 总是返回类似 <code>P2Y3M1D 或 P-1M 的 ISO-8601 格式，不含空格、单位全大写、负号只出现在最前面。这看似规范，但容易误判：

没有 P0Y 这种省略项——如果年份为 0，getYears() 返回 0，但 toString() 不显示 Y 部分
负 Period（end 在 start 之前）会整体带负号：Period.between(end, start) ≠ Period.between(start, end).negated()？其实等价，但要注意 negated() 是安全的，而手动取反字段（如 -p.getYears()）会破坏内部一致性
别用字符串拆解来提取数值——直接调用 p.getYears()、p.getMonths()、p.getDays()