Period用于日历日期差（年/月/日），Duration用于精确时钟差（时/分/秒/纳秒）；前者基于日历规则，后者基于固定纳秒数，二者不可互换。
Period 和 Duration 看起来都算“时间差”，但它们根本不在一个维度上——前者管「日历日期」，后者管「精确时钟」；混用会直接抛 DateTimeException。
什么时候该用 Period？只和年/月/日打交道时
当你想回答“出生到现在过了几年几个月几天”“合同从2023-03-15到2025-11-20一共多少个月零几天”这类问题时，Period 是唯一合法选择。
-
Period.between()只接受两个LocalDate（不能是LocalDateTime或Instant） - 它内部按日历规则计算：比如 2024-01-31 到 2024-02-29 是 1 个月，不是 28 天
-
getDays()返回的是“剩余天数”，不是总天数；要总天数得用period.toTotalMonths()或手动转ChronoUnit.DAYS.between() - 错误示例：
Period.between(LocalDateTime.now(), LocalDateTime.of(2025,1,1,0,0))→ 抛异常
LocalDate start = LocalDate.of(1990, 5, 15); LocalDate end = LocalDate.of(2026, 1, 20); Period p = Period.between(start, end); System.out.println(p.getYears() + "年" + p.getMonths() + "月" + p.getDays() + "天"); // 输出：35年8月5天
什么时候该用 Duration？只要涉及时/分/秒/毫秒精度
当你需要知道“任务执行了多久”“API响应耗时多少纳秒”“两个时刻之间相隔几小时几分钟”时，必须用 Duration。
-
Duration.between()接受LocalTime、LocalDateTime、ZonedDateTime、Instant，但**不能传LocalDate**（会报错） - 它底层只算“总纳秒数”，不考虑闰年、夏令时、月份天数差异
- 输出格式是 ISO-8601 的
PT2H30M15.123S，不是人话；要用toHours()、toMinutes()等显式转换 - 注意：
Duration没有toDays()的精度保障——如果间隔不足 1 天，toDays()返回 0；要用toDaysPart()+toHoursPart()拆解
LocalDateTime start = LocalDateTime.of(2026, 1, 20, 2, 0, 0); LocalDateTime end = LocalDateTime.of(2026, 1, 20, 4, 30, 15); Duration d = Duration.between(start, end); System.out.println(d.toHours() + "小时" + d.toMinutesPart() + "分钟" + d.getSecondsPart() + "秒"); // 输出：2小时30分钟15秒
为什么不能互相替代？单位系统和语义完全不同
Period 是日历单位（calendar-based），Duration 是时钟单位（clock-based）——这决定了它们无法对齐。
立即学习“Java免费学习笔记（深入）”；
- “1个月”在
Period中可能是 28、29、30 或 31 天；但在Duration中没有“月”这个概念，只有固定秒数（如Duration.ofDays(30)） -
Period.ofMonths(1)加到LocalDate.of(2024,1,31)得到2024-02-29（自动归约）；而Duration.ofDays(30)加到同一天就是硬加 30 天 →2024-03-01 - 跨时区场景下，
Duration依然可靠（因为基于Instant），而Period在时区转换中可能丢失语义（比如某地某月只有28天）
容易踩的坑：常见错误现象与修复方式
真实项目里，90% 的时间间隔 bug 都源于类型误用或单位混淆。
-
错误：用
Duration.between(LocalDate, LocalDate)→ 报UnsupportedTemporalTypeException；修复：改用ChronoUnit.DAYS.between(d1, d2)或先转成atStartOfDay() -
错误：把
Period当总天数用 →p.getDays()可能是 5，但实际跨度几百天；修复：明确需求，真要总天数就别用Period，改用ChronoUnit.DAYS.between() -
错误：用
Duration计算生日还剩几天 → 因为没考虑年份变化，结果永远是负数或不准；修复：生日是日期问题，必须用Period或LocalDate.until() -
错误：认为
Period.parse("P1M")和Duration.ofDays(30)等价 → 它们语义不同，不可互换，也不可比较大小
真正关键的不是记 API，而是每次写时间差逻辑前，先问自己一句：这个问题，答案是否依赖日历（比如“下个月今天”）？如果是，闭眼用 Period；否则，一律上 Duration 或 ChronoUnit。
