Period与Duration区别详解：Java时间处理核心差异

Java中Period与Duration虽同为时间差计算工具，却分属完全不同的语义维度：Period专精于日历日期的动态计算（如“几年几个月几天”，尊重闰年、月份天数等日历规则），而Duration专注精确时钟跨度（如“几小时几分钟几秒”，基于固定纳秒数，无视日历变化）；二者类型不兼容、不可互换，误用轻则抛出DateTimeException，重则导致业务逻辑错误——选Period还是Duration，关键不在API怎么写，而在你问的问题本质：答案是否依赖日历？是，则用Period；否则，果断选Duration或ChronoUnit。

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）——这决定了它们无法对齐。

• “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。

今天关于《Period与Duration区别详解：Java时间处理核心差异》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！