❤️高级JAVA开发必备技能❤️java8 新日期时间API（JSR-310：常用计算工具），2万字详解（JAVA 小虚竹，建议收藏）

Posted 2021-09-28 小虚竹

❤️作者简介：Java领域优质创作者🏆，博客专家认证🏆
❤️技术活，该赏
❤️点赞 👍 收藏 ⭐再看，养成习惯

大家好，我是小虚竹。之前有粉丝私聊我，问能不能把JAVA8 新的日期时间API（JSR-310）知识点梳理出来。答案是肯定的，谁让我宠粉呢。由于内容偏多（超十万字了），会拆成多篇来写。

闲话就聊到这，请看下面的正文。

文章目录

• 常用于计算的类介绍
• Duration
• • Duration类说明
  • Duration常用的用法
  • • 创建Duration对象
    • 访问Duration的时间
    • Duration计算
• Period
• • Period类说明
  • Period常用的用法
  • • 创建Period对象
    • 访问Period的时间
    • Duration计算
• TemporalUnit
• • TemporalUnit类说明
  • ChronoUnit常用的用法
• TemporalField
• • TemporalField类说明
  • ChronoField常用的用法
• ValueRange
• • ValueRange类说明
  • ValueRange常用的用法
• Chronology 判断是否闰年
• • 实战
• 比较日期时间的先后
• • 比较-LocalDate
  • 比较-LocalTime
  • 比较-OffsetDateTime
  • 比较-OffsetTime
  • 比较-ZonedDateTime
• 计算日期时间的间隔
• 推荐相关文章
• • hutool日期时间系列文章
  • 其他

常用于计算的类介绍

介绍下java8 中提供了几个常用于计算的类：

• Duration：表示秒和纳秒的时间量
• Period：表示年月日的时间量
• TemporalUnit：日期时间的基本单位
• TemporalField：日期时间的属性
• ValueRange：表示取值范围

Duration

Duration类说明

包路径：java.time.Duration

public final class Duration
        implements TemporalAmount, Comparable<Duration>, Serializable {
    private final long seconds;
   
    private final int nanos;
        ...
        }

Duration 是TemporalAmount 的实现类，类里包含两个变量seconds 和 nanos ，所以Duration 是由秒和纳秒组成的时间量。

一个Duration实例是不可变的，当创建出对象后就不能改变它的值了。

Duration常用的用法

创建Duration对象

Duration 适合处理较短的时间，需要更高的精确性。我们能使用between()方法比较两个瞬间的差：

		Instant first = Instant.now();
		try {
			Thread.sleep(1000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		Instant second = Instant.now();
		Duration duration = Duration.between(first, second);
		System.out.println(duration);

可以通过LocalDateTime 类获取获取Duration对象

		LocalDateTime first = LocalDateTime.of(2021, 8, 30, 23, 14, 20);

		LocalDateTime second = LocalDateTime.of(2021, 8, 30, 23, 13, 0);

		Duration duration = Duration.between(first, second);
		System.out.println(duration);

访问Duration的时间

Duration 对象中可以获取秒和纳秒属性。但没有毫秒属性，跟System.getCurrentTimeMillis()不同。

	Instant first = Instant.now();
		try {
			Thread.sleep(1000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		Instant second = Instant.now();
		Duration duration = Duration.between(first, second);
		System.out.println(duration);
		System.out.println("秒:"+duration.getSeconds());
		System.out.println("纳秒："+duration.getNano());

可以转换整个时间成其他单位，如纳秒，毫秒，分钟，小时，天

		Instant first = Instant.now();
		try {
			Thread.sleep(1000);
		} catch (InterruptedException e) {
			e.printStackTrace();
		}
		Instant second = Instant.now();
		Duration duration = Duration.between(first, second);
		System.out.println(duration);
		System.out.println("秒:"+duration.getSeconds());
		System.out.println("纳秒："+duration.getNano());
		System.out.println("纳秒:"+duration.toNanos());
		System.out.println("毫秒："+duration.toMillis());
		System.out.println("分："+duration.toMinutes());
		System.out.println("小时："+duration.toHours());
		System.out.println("天："+duration.toDays());

由图上可知，getNano 方法和toNanos 方法不太一样，前者是获取这段时间的小于1s的部分，后者是整个时间转化为纳秒。

Duration计算

plusNanos()
plusMillis()
plusSeconds()
plusMinutes()
plusHours()
plusDays()
minusNanos()
minusMillis()
minusSeconds()
minusMinutes()
minusHours()
minusDays()

以plusSeconds 和minusSeconds 为例：

LocalDateTime first = LocalDateTime.of(2021, 8, 30, 23, 14, 20);
		LocalDateTime second = LocalDateTime.of(2021, 8, 30, 23, 13, 0);
		Duration duration = Duration.between(first, second);
		System.out.println(duration);

		Duration duration1 = duration.plusSeconds(10);
		System.out.println("plusSeconds 后："+duration);
		System.out.println("plusSeconds 后新的Duration对象："+duration1);

		Duration duration2 = duration.minusSeconds(10);
		System.out.println("minusSeconds 后："+duration);
		System.out.println("minusSeconds 后新的Duration对象："+duration2);

由上面的验证可知，这些计算方法执行后，会返回一个新的Duration对象，原先的Duration对象不变。

Period

Period类说明

包路径：java.time.Period

public final class Period
        implements ChronoPeriod, Serializable {
            /**
     * The number of years.
     */
    private final int years;
    /**
     * The number of months.
     */
    private final int months;
    /**
     * The number of days.
     */
    private final int days;
        ...
        }

Period 是ChronoPeriod 的实现类，类里包含两个变量years ,months 和 days ，所以Period 是由年，月和日组成的时间量。

Period常用的用法

创建Period对象

		LocalDate first = LocalDate.of(2021, 8, 29);
		LocalDate second = LocalDate.of(2022, 9, 30);
		Period period = Period.between(first, second);
		System.out.println(period);

访问Period的时间

		LocalDate first = LocalDate.of(2021, 8, 28);
		LocalDate second = LocalDate.of(2022, 10, 31);
		Period period = Period.between(first, second);
		System.out.println(period);
		System.out.println("年:"+period.getYears());
		System.out.println("月："+period.getMonths());
		System.out.println("日："+period.getDays());

可以转换整个时间成其他单位,月

LocalDate first = LocalDate.of(2021, 8, 29);		
LocalDate second = LocalDate.of(2022, 9, 30);		
Period period = Period.between(first, second);	
	System.out.println(period);	
	System.out.println("月:"+period.toTotalMonths());

由图上可知，getMonths 方法和toTotalMonths 方法不太一样，前者是获取这段时间的月的部分，后者是整个时间转化为以月为单位长度。

toTotalMonths 源码：

public long toTotalMonths() {        
return years * 12L + months;  // no overflow    
}

Duration计算

plusDays()
plusMonths()
plusYears()

minusDays()
minusMonths()
minusYears()

以plusMonths 和minusMonths 为例：

		LocalDate first = LocalDate.of(2021, 8, 28);
		LocalDate second = LocalDate.of(2022, 10, 31);
		Period period = Period.between(first, second);
		System.out.println(period);
		Period period1 = period.plusMonths(1);
		System.out.println("plusMonths 后："+period);
		System.out.println("plusMonths 后新的Period对象："+period1);

		Period period2 = period.minusMonths(1);
		System.out.println("minusMonths 后："+period);
		System.out.println("minusMonths 后新的Period对象："+period2);

由上面的验证可知，这些计算方法执行后，会返回一个新的Period对象，原先的Period对象不变。

TemporalUnit

TemporalUnit类说明

包路径：java.time.temporal.TemporalUnit

public interface TemporalUnit {
...
}

public enum ChronoUnit implements TemporalUnit {    
private final String name;   
 private final Duration duration; 
   ...
   }

TemporalUnit 主要实现类是枚举类型ChronoUnit

一个ChronoUnit成员会维护一个字符串名字属性name和一个Duration类型的实例。

其中ChronoUnit枚举了标准的日期时间单位集合，就是常用的年、月、日、小时、分钟、秒、毫秒、微秒、纳秒，这些时间单位的时间量到底是多少，代表多长的时间，在该枚举类中都有定义。

public enum ChronoUnit implements TemporalUnit {
 
    NANOS("Nanos", Duration.ofNanos(1)),
    MICROS("Micros", Duration.ofNanos(1000)),
    MILLIS("Millis", Duration.ofNanos(1000_000)),
    SECONDS("Seconds", Duration.ofSeconds(1)),
    MINUTES("Minutes", Duration.ofSeconds(60)),
    HOURS("Hours", Duration.ofSeconds(3600)),
    HALF_DAYS("HalfDays", Duration.ofSeconds(43200)),
    DAYS("Days", Duration.ofSeconds(86400)),
    WEEKS("Weeks", Duration.ofSeconds(7 * 86400L)),
    MONTHS("Months", Duration.ofSeconds(31556952L / 12)),
    YEARS("Years", Duration.ofSeconds(31556952L)),
    DECADES("Decades", Duration.ofSeconds(31556952L * 10L)),
    CENTURIES("Centuries", Duration.ofSeconds(31556952L * 100L)),
    MILLENNIA("Millennia", Duration.ofSeconds(31556952L * 1000L)),
    ERAS("Eras", Duration.ofSeconds(31556952L * 1000_000_000L)),
    FOREVER("Forever", Duration.ofSeconds(Long.MAX_VALUE, 999_999_999));     
 
    private final String name;
    private final Duration duration;
 
    private ChronoUnit(String name, Duration estimatedDuration) {
        this.name = name;
        this.duration = estimatedDuration;
    }
    ···
}

ChronoUnit常用的用法

		LocalDateTime localDateTime = LocalDateTime.of(2021, 8, 30, 23, 14, 20);
		LocalDateTime offset = localDateTime.plus(1, ChronoUnit.DAYS);
		// 非同一对象
		Assert.assertNotSame(localDateTime, offset);
		System.out.println(offset);

TemporalField

TemporalField类说明

包路径：java.time.temporal.TemporalField

public interface TemporalField {
    ...
}

public enum ChronoField implements TemporalField {
     private final String name;
    private final TemporalUnit baseUnit;
    private final TemporalUnit rangeUnit;
    private final ValueRange range;
    ...
}

TemporalField 主要实现类是枚举类型ChronoField

一个ChronoField成员会维护一个字符串名字属性name、一个TemporalUnit的基础单位baseUnit、一个TemporalUnit的表示范围的单位rangeUnit和一个ValueRange类型的range用于表示当前属性的范围。

public enum ChronoField implements TemporalField {
    //一秒钟的纳秒数
    NANO_OF_SECOND("NanoOfSecond", NANOS, SECONDS, ValueRange.of(0, 999_999_999))
    //一分钟的秒数
    SECOND_OF_MINUTE("SecondOfMinute", SECONDS, MINUTES, ValueRange.of(0, 59), "second")
    //一个小时的分钟数
    MINUTE_OF_HOUR("MinuteOfHour", MINUTES, HOURS, ValueRange.of(0, 59), "minute")
    //一上午或者一下午有多少个小时
    CLOCK_HOUR_OF_AMPM("ClockHourOfAmPm", HOURS, HALF_DAYS, ValueRange.of(1, 12))
    //一天的小时数
    CLOCK_HOUR_OF_DAY("ClockHourOfDay", HOURS, DAYS, ValueRange.of(1, 24))
    //上午还是下午
    AMPM_OF_DAY("AmPmOfDay", HALF_DAYS, DAYS, ValueRange.of(0, 1), "dayperiod")
    //一周的第几天
    DAY_OF_WEEK(❤️高级JAVA开发必备技能❤️java8 新日期时间API（JSR-310：格式化和解析），2万字详解（JAVA 小虚竹，建议收藏）

 高级JAVA开发必备技能：java8 新日期时间API（JSR-310：实战+源码分析）（JAVA 小虚竹）
 高级JAVA开发必备技能：java8 新日期时间API（JSR-310：常用计算工具）（JAVA 小虚竹）
 ❤️高级JAVA开发必备技能❤️java8 JSR-310判断是否闰年实现，发现原作者的代码可能有问题（JAVA 小虚竹，建议收藏）
 高级JAVA开发必备技能：java8 JSR-310判断是否闰年实现，发现原作者的代码可能有问题（JAVA 小虚竹）
 高级JAVA开发必备技能：java8 新日期时间API（JSR-310：常用的日期时间API）（JAVA 小虚竹）