java时间单位框架接口TemporalUnit及其实现类ChronoUnit

java时间工具类我们经常使用，今天先从最基本的时间单位说起，时间单位这个概念有一个接口就是TemporalUnit，它有唯一一个实现类ChronoUnit，该类也是一个枚举类。

接口TemporalUnit的抽象方法有以下几个

 我们取其中三个最为常用的，分别是：

1 <R extends Temporal> R addTo(R temporal, long amount) 返回添加指定句点的指定时间对象的副本

2 long between(Temporal temporal1Inclusive, Temporal temporal2Exclusive) 计算两个时间对象之间的时间量

3 Duration getDuration() 获取此单位的持续时间

并用其实现类ChronoUnit来调用，代码如下

@Test
    public void test_TemporalUnit(){
        // 所有已知实现类：
        // Enum ChronoUnit 其实本质还是用Duration作为成员变量

        // <R extends Temporal> R addTo(R temporal, long amount) 返回添加指定句点的指定时间对象的副本 调用的是temporal.plus(amount, this)
        LocalDateTime time = ChronoUnit.YEARS.addTo(LocalDateTime.now(), 1);
        LocalDateTime time1 = ChronoUnit.MONTHS.addTo(LocalDateTime.now(), 1);
        LocalDateTime time2 = ChronoUnit.WEEKS.addTo(LocalDateTime.now(), 1);
        LocalDateTime time3 = ChronoUnit.DAYS.addTo(LocalDateTime.now(), 1);
        LocalDateTime time4 = ChronoUnit.HOURS.addTo(LocalDateTime.now(), 1);
        LocalDateTime time5 = ChronoUnit.MINUTES.addTo(LocalDateTime.now(), 1);
        LocalDateTime time6 = ChronoUnit.SECONDS.addTo(LocalDateTime.now(), 1);

//        Instant instant = ChronoUnit.YEARS.addTo(Instant.now(), 1);
//        Instant instant1 = ChronoUnit.MONTHS.addTo(Instant.now(), 1);
//        Instant instant2 = ChronoUnit.WEEKS.addTo(Instant.now(), 1);
        Instant instant3 = ChronoUnit.DAYS.addTo(Instant.now(), 1);
        Instant instant4 = ChronoUnit.HOURS.addTo(Instant.now(), 1);
        Instant instant5 = ChronoUnit.MINUTES.addTo(Instant.now(), 1);
        Instant instant6 = ChronoUnit.SECONDS.addTo(Instant.now(), 1);

        // long between(Temporal temporal1Inclusive, Temporal temporal2Exclusive) 计算两个时间对象之间的时间量。
        long between = ChronoUnit.YEARS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between1 = ChronoUnit.MONTHS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between2 = ChronoUnit.WEEKS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between3 = ChronoUnit.DAYS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between4 = ChronoUnit.HOURS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between5 = ChronoUnit.MINUTES.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());
        long between6 = ChronoUnit.SECONDS.between(LocalDateTime.of(2022, 2, 2, 2, 2, 2), LocalDateTime.now());

//        long between7 = ChronoUnit.YEARS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
//        long between8 = ChronoUnit.MONTHS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
//        long between9 = ChronoUnit.WEEKS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
        long between10 = ChronoUnit.DAYS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
        long between11 = ChronoUnit.HOURS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
        long between12 = ChronoUnit.MINUTES.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());
        long between13 = ChronoUnit.SECONDS.between(Instant.parse("2022-02-02T02:02:02.000Z"), Instant.now());

        //Duration getDuration() 获取此单位的持续时间，这可能是一个估计
        Duration duration1 = ChronoUnit.YEARS.getDuration();
        Duration duration2 = ChronoUnit.MONTHS.getDuration();
        Duration duration3 = ChronoUnit.WEEKS.getDuration();
        Duration duration4 = ChronoUnit.DAYS.getDuration();
        Duration duration5 = ChronoUnit.HOURS.getDuration();
        Duration duration6 = ChronoUnit.MINUTES.getDuration();
        Duration duration7 = ChronoUnit.SECONDS.getDuration();
        Duration duration8 = ChronoUnit.DAYS.getDuration();

    }

 第一个方法是<R extends Temporal> R addTo(R temporal, long amount)，用于返回一个在指定时间上添加指定时间段后的新时间，这个Temporal是时刻抽象出的接口，实现它的有咱们常用的Instant和LocalDate、LocalTime、LocalDateTime等等，我们这里只以Instant和LocalDateTime举例来调用该方法

 可以看到得到的新的LocalDateTime对象都是本地时间加上了指定的时间后的新时间，但是Instant并不是本地时间，这是因为Instant.now()获得的是格林尼治标准时间，即零时区的时间，咱们本地时间即北京时间是东八区，所以你会发现这个Instant对象的时间跟本地时间差8个小时，另外一点Instant对象是不能加上以年、月、星期为时间单位的时间的，我把那三行代码注释了，运行的话会报以下错误

 咱们看这个addTo的源码，发现它调用的是temporal接口的plus方法，

 这个temporal接口是用来定义时间框架的，像表示时间点（时刻）的Instant、LocalDateTime、ZonedDateTime这些都是它的实现类，所以我们分别来看Instant和LocalDateTime的plus方法的实现，

 可以看到对于Instant来说，只能以纳秒、微秒、毫秒、秒、分、小时、半天、一天为单位进行增加，其余单位会抛出异常，而LocalDateTime却还能通过调用LocalDate的plus方法来实现这些单位的增加。

第二个方法是long between(Temporal temporal1Inclusive, Temporal temporal2Exclusive) 计算两个时间对象之间的时间量。同样，Instant对象是不能以年、月、星期为时间单位返回两个时间的间隔的。

 第三个就是Duration getDuration() 获取此单位的持续时间，这个没什么要特别注意的，按示例代码运行一下就懂了。

后边几篇会将时间的时间段的抽象接口TemporalAmount和时刻的抽象接口TemporalAccessor跟大家聊一聊，有什么问题还请大家指正。