java8时间间隔类Duration和Period示例代码

 更新时间:2026年04月08日 10:11:05   作者:五阿哥永琪  
文章解释了Java中Duration和Period的区别,并提供了它们的特点、适用场景和常见用途,文中还提供了每个类的常用方法和示例,感兴趣的朋友一起看看吧

在 Java 的时间宇宙里,有两个专门用来“丈量时间间隔”的角色,它们像两种不同的尺子,一个量“钟表时间”,一个量“日期跨度”。主角就是:
👉 DurationPeriod
我带你拆开看,它们到底哪里不一样。

一、Duration(时间间隔:精确到秒/纳秒 ⏱️)

Duration 用来表示基于时间的间隔,适合描述“具体流逝了多少时间”。

✅ 特点

  • 基于 秒(seconds)和纳秒(nanoseconds)
  • 适合处理:
    • 时、分、秒
    • 精确时间计算
  • 常用于:
    • 接口超时
    • 任务耗时统计
    • 时间差计算

✅ 示例

Duration duration = Duration.between(startTime, endTime); 
long seconds = duration.getSeconds(); // 总秒数 
long millis = duration.toMillis(); // 转毫秒

二、Period(日期间隔:年/月/日 📅)

Period 用来表示基于日期的间隔,关注的是“日历上的跨度”。

✅ 特点

  • 基于 年、月、日
  • 不涉及具体时间(时分秒)
  • 常用于:
    • 年龄计算
    • 日期差(多少天/多少个月)
    • 账期、周期计算

✅ 示例

Period period = Period.between(startDate, endDate);
int years = period.getYears();
int months = period.getMonths();
int days = period.getDays();

三、核心区别

对比点DurationPeriod
类型时间间隔日期间隔
精度秒 / 纳秒年 / 月 / 日
是否包含时间✅ 包含(时分秒)❌ 不包含
适用对象LocalDateTime、InstantLocalDate
是否考虑月份长度❌ 不关心✅ 会考虑(28/30/31天)
常见用途耗时统计、超时控制年龄、日期差

四、举个直观例子 🌰

假设:

2024-01-01 00:00 → 2024-01-02 00:00

Duration

👉 得到:86400秒

Period

👉 得到:1天

再来一个更有意思的:

2024-01-31 → 2024-02-28

Period

👉 结果:0个月28天(因为2月没有31号)

Duration

👉 结果:秒数差(固定值)

五、常用方法

一、Duration常用方法(时间流逝型 ⏱️)

👉 适合:时 / 分 / 秒 / 纳秒

1️⃣ 创建对象

Duration.ofSeconds(60);
Duration.ofMinutes(10);
Duration.ofHours(2);
Duration.ofDays(1);
Duration.between(start, end);

2️⃣ 获取时间

duration.getSeconds();     // 总秒数  
duration.toMillis();       // 转毫秒  
duration.toMinutes();      // 转分钟  
duration.toHours();        // 转小时

3️⃣ 运算操作

duration.plusSeconds(30);  // 加30秒  
duration.minusMinutes(5);  // 减5分钟  
duration.multipliedBy(2);  // 乘2  
duration.dividedBy(2);     // 除2

4️⃣ 判断

duration.isNegative();     // 是否负数  
duration.isZero();         // 是否为0

5️⃣ 格式输出

duration.toString(); // PT10M(ISO-8601格式)

👉 像:PT2H30M(2小时30分钟)

二、Period常用方法(日历跨度型 📅)

👉 适合:年 / 月 / 日

1️⃣ 创建对象

Period.of(1, 2, 3);   // 1年2月3天  
Period.ofYears(2);  
Period.ofMonths(6);  
Period.ofDays(10);  
Period.between(startDate, endDate);

2️⃣ 获取时间

period.getYears();  
period.getMonths();  
period.getDays();

⚠️ 注意:不是总天数,而是“拆分后的年月日”

3️⃣ 运算操作

period.plusDays(5);  
period.minusMonths(2);  
period.multipliedBy(2);

4️⃣ 判断

period.isZero();  
period.isNegative();

5️⃣ 规范化(很关键🔥)

period.normalized();

👉 作用:把 15个月 → 1年3个月

6️⃣ 格式输出

period.toString(); // P1Y2M3D

到此这篇关于java8时间间隔类Duration和Period示例代码的文章就介绍到这了,更多相关java duration和period内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 详解Spring 中 Bean 的生命周期

    详解Spring 中 Bean 的生命周期

    这篇文章主要介绍了Spring 中 Bean 的生命周期的相关资料,帮助大家更好的理解和使用spring框架,感兴趣的朋友可以了解下。
    2021-01-01
  • spring boot使用properties定义短信模板的方法教程

    spring boot使用properties定义短信模板的方法教程

    这篇文章主要给大家介绍了关于spring boot使用properties定义短信模板的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-01-01
  • Java扩展Nginx之共享内存

    Java扩展Nginx之共享内存

    这篇文章主要介绍了Java扩展Nginx之共享内存的相关资料,需要的朋友可以参考下
    2023-07-07
  • SpringBoot中自定义参数绑定步骤详解

    SpringBoot中自定义参数绑定步骤详解

    这篇文章主要介绍了SpringBoot中自定义参数绑定步骤详解,非常不错,具有参考借鉴价值 ,需要的朋友可以参考下
    2018-02-02
  • 教你代码中获取当前 JAR 包的存放位置

    教你代码中获取当前 JAR 包的存放位置

    这篇文章主要介绍了如何获取当前JAR包的存放位置,要获取当前运行的 JAR 包所存放的位置,可以使用 ProtectionDomain 和 CodeSource 类,本文结合实例代码给大家介绍的非常详细,需要的朋友可以参考下
    2023-08-08
  • Java并发之AQS与自旋锁详解

    Java并发之AQS与自旋锁详解

    这篇文章主要介绍了Java并发之AQS与自旋锁详解,类如其名,抽象的队列式的同步器,AQS定义了一套多线程访问共享资源的同步器框架,许多同步类实现都依赖于它,如常用的ReentrantLock/Semaphore/CountDownLatch,需要的朋友可以参考下
    2023-10-10
  • Spring-IOC容器-Bean管理-基于XML方式超详解

    Spring-IOC容器-Bean管理-基于XML方式超详解

    这篇文章主要介绍了Spring为IOC容器Bean的管理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2021-08-08
  • SpringBoot 整合jdbc和mybatis的方法

    SpringBoot 整合jdbc和mybatis的方法

    该文章主要为记录如何在SpringBoot项目中整合JDBC和MyBatis,在整合中我会使用简单的用法和测试用例,感兴趣的朋友跟随小编一起看看吧
    2019-11-11
  • IntelliJ IDEA 2021.1 首个 Beta 版本发布

    IntelliJ IDEA 2021.1 首个 Beta 版本发布

    这篇文章主要介绍了IntelliJ IDEA 2021.1 首个 Beta 版本发布,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • SpringCloud Gateway详细分析实现负载均衡与熔断和限流

    SpringCloud Gateway详细分析实现负载均衡与熔断和限流

    这篇文章主要介绍了SpringCloud Gateway实现路由转发,负载均衡,熔断和限流,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07

最新评论