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

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 的日期」。这意味着结果不是数学差值，而是语义对齐的结果。

例如：

Java注释规范Skills

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

下载

立即学习“Java免费学习笔记（深入）”；

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”完全不同。

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

   的分配</li>
  </ul>
  
  <H3>toString() 输出格式固定，解析需谨慎</H3>
  <p><code>Period.toString()

  总是返回类似 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()

  替代方案：需要总月数或总天数时别硬套 Period

  当业务要的是「从入职到今天一共多少个月」这种连续计数，Period 反而容易出错（比如 1月31日到2月28日算1个月，但1月30日到2月28日也算1个月，实际天数差不同）。

  • 要总月数：用 ChronoUnit.MONTHS.between(startDate, endDate) —— 它按日历月滚动计数，忽略具体日期
  • 要总天数：用 ChronoUnit.DAYS.between(startDate, endDate) —— 精确到天，不涉及月份长度
  • 要「年+剩余月+剩余日」且可逆（即加回去严格等于原日期），才用 Period.between()

  真正难的不是调用 API，而是想清楚你要的到底是日历偏移量，还是线性时间跨度。这两个概念在 Java 8 时间 API 里被明确分开了，混用就会踩坑。