深入了解Java Period类，对时间段的精确控制

news2024/10/1 5:37:06

阅读建议

嗨，伙计！刷到这篇文章咱们就是有缘人，在阅读这篇文章前我有一些建议：

本篇文章大概2900多字，预计阅读时间长需要3分钟。
本篇文章的实战性、理论性较强，是一篇质量分数较高的技术干货文章，建议收藏起来，方便时常学习与回顾，温故而知新。
创作不易，免费的点赞、关注，请走上一走，算是对博主一些鼓励，让我更有动力输出更多的干货内容。

注意

本文编写的单元测试是基于java11，具体的版本号是：11.0.19

Period

在Java中，Period类是用于表示时间段或周期的类。它通常用于日期和时间的计算和操作，可以方便地处理年、月、日等时间单位。下面是一个如何定义Period的示例：

@Test
public void test() {
    Period period = Period.of(1, 1, 1);//获得一个表示一年一个月一天的时间段
    LocalDate localDate = LocalDate.of(2023, 1, 1);
    LocalDate plus = localDate.plus(period);//计算当前日期加上指定的时间段后的日期
    System.out.println(plus);//输出结果：2024-02-02
    Period period1 = Period.ofYears(1);//获得一个表示一年的时间段
    Period period2 = Period.ofMonths(12);//获得一个表示十二个月的时间段
    Period period3 = Period.ofDays(30);//获得一个表示三十天的时间段
    Period period4 = Period.ofWeeks(1);//获得一个表示两周的时间段
}

核心方法

Period的核心方法包括：

Period.of(LocalDate startDate, LocalDate endDate)：创建一个表示给定时间段的Period对象。
Period.between(LocalDate startDate, LocalDate endDate)：创建一个表示给定时间段的Period对象，与起始日期和结束日期的时间顺序无关。
Period.getYears()：返回时间段中的年数。
Period.getMonths()：返回时间段中的月数。
Period.getDays()：返回时间段中的天数。
Period.plus(Period period)：将给定的Period对象加到当前Period对象上，返回一个新的Period对象。
Period.minus(Period period)：将给定的Period对象从当前Period对象中减去，返回一个新的Period对象。
Period.between(LocalDateTime startDateTime, LocalDateTime endDateTime)：创建一个表示给定时间段的Period对象，与起始日期和结束日期的时间顺序无关。

@Test
public void test1() {
    LocalDate localDate1 = LocalDate.of(2022, 1, 1);
    LocalDate localDate2 = LocalDate.of(2023, 12, 1);
    Period period = Period.between(localDate1, localDate2);
    System.out.println(period.getYears());//输出结果：1
    System.out.println(period.getMonths());//输出结果：11
    System.out.println(period.getDays());//输出结果：0，注意：这里的结果是对应的年、月、日的字段的值的差，与起始日期和结束日期的时间顺序无关
    //如果想要获取两个日期之间的差是多少天，可以这样：
    long days = localDate1.until(localDate2, ChronoUnit.DAYS);
    System.out.println(days);//输出结果：699
}

Period#plus(...)：该方法接受一个Period对象作为参数，并将其加到当前Period对象上，返回一个新的Period对象。

@Test
public void test2() {
    Period period = Period.ofYears(1);//获得一个表示一年的时间段
    period.plus(Period.ofYears(1));//计算当前时间段加上一个1年时间后的时间段
    period.plusYears(1);//计算当前时间段加上一个1年时间后的时间段
    period.plusMonths(12);//计算当前时间段加上一个12个月时间后的时间段
    period.plusDays(365);//计算当前时间段加上一个365天时间后的时间段
}

Period#minus(...)：该方法也接受一个Period对象作为参数，但它将从当前Period对象中减去给定的Period对象，返回一个新的Period对象。

@Test
public void test3() {
    Period period = Period.ofYears(1);//获得一个表示一年的时间段
    period.minus(Period.ofYears(1));//计算当前时间段减去一个1年时间后的时间段
    period.minusYears(1);//计算当当前时间段减去一个1年时间周期后的时间段
    period.minusMonths(12);//计算当前时间段减去一个12个月时间周期后的时间段
    period.minusDays(365);//计算当前时间段减去一个365天时间周期后的时间段
}