1. 旧版时间api

1、设计不合理
2、 时间格式化和解析是线程不安全的
3、处理时区麻烦

image.png

2. 新版时间api

位于java.time包中。
localDate：表示日期，包含年月日，格式为2020-02-02
localTime：表示时间，包含时分秒，格式为16:38:25.158549300
localDateTime：表示日期时间，包含年月日，格式为2020-02-02T16:38:25.158549300
DateTimeFormatter：日期时间格式化类
Instant：时间戳，表示一个特定的时间瞬间
Duration：用于计算两个时间(localTime)的距离
Period：用于计算两个日期(localDate)的距离
ZoneDateTime：包含时区的时间

3. 日期和时间类

localDate、localTime、localDateTime类的实例是不可变的对象，分别表示日期，时间和日期时间。
这三个类的方法基本一致：

• now：获取当前
• of：自定义
• getAttribute：获取对应的时间属性
• withAttribute：修改对应的时间属性
• plusAttribute：增加指定的时间
• minusAttribute：减去指定的时间
• isAfter isBefore isEqual：时间比较

3.1 LocalDate

        // now获取当前日期
        LocalDate now = LocalDate.now();
        System.out.println(now);  // 2019-08-09

        // of自定义日期
        LocalDate of = LocalDate.of(2092,10,8);
        System.out.println(of);

        // getYear getMonth getDayOfMonth getMonthValue getDayOfWeek
        System.out.println(of.getYear());
        System.out.println(of.getMonth());
        System.out.println(of.getMonthValue());
        System.out.println(of.getDayOfWeek());

3.2 LocalTime

        // LocalTime
        // now获取当前时间
        LocalTime now = LocalTime.now();
        System.out.println(now);

        LocalTime of = LocalTime.of(13, 26, 14);
        System.out.println(of);

        int hour = of.getHour();
        int minute = of.getMinute();
        int second = of.getSecond();

3.3 localDateTime

        // LocalDateTime
        LocalDateTime now = LocalDateTime.now();
        System.out.println(now);

        LocalDateTime of = LocalDateTime.of(2092, 10, 8, 13, 26, 14);
        System.out.println(of);

        System.out.println(of.getYear());
        System.out.println(of.getMonthValue());
        System.out.println(of.getSecond());

3.4 修改计算时间

        // 修改时间 通过with,修改后会返回一个新的时间
        LocalDateTime localDateTime = of.withYear(2021);
        System.out.println(localDateTime);
        System.out.println(of);

        // 增加或减去时间
        LocalDateTime ptime = now.plusYears(2L);
        LocalDateTime mtime = now.minusMonths(2L);

3.5 比较时间

        boolean after = ptime.isAfter(mtime);
        boolean before = ptime.isBefore(mtime);
        boolean equal = ptime.isEqual(mtime);

4. 时间格式化与解析

4.1 格式化

首先通过DateTimeFormatter的ofPattern方法自定义时间的格式，
然后将这个格式对象作为参数通过format方法给日期时间调用，
返回一个字符串，这个字符串就是自定义的格式。

        // Jdk自带格式
        DateTimeFormatter dtf = DateTimeFormatter.ISO_DATE_TIME;
        String format1 = now.format(dtf);
        System.out.println("Jdk自带格式：" + format1);

        DateTimeFormatter dtf2 = DateTimeFormatter.ofPattern("yyyy年MM月dd HH时mm分ss秒");
        String format2 = now.format(dtf2);
        System.out.println("自定义格式：" + format2);

// Jdk自带格式：2019-02-09T16:59:10.833
// 自定义格式：2019年02月09 16时59分10秒

4.2 解析

首先通过DateTimeFormatter的ofPattern方法自定义时间的格式，
然后将这个格式对象作为参数和时间格式的字符串一起通过parse方法给日期时间调用解析，
返回的就是一个DateTime。

        DateTimeFormatter dtf3 = DateTimeFormatter.ofPattern("yyyy年MM月dd HH时mm分ss秒");
        LocalDateTime parse = LocalDateTime.parse("2019年02月09 16时59分10秒", dtf3);
        System.out.println(parse);

        // 默认格式是可以直接解析的
        LocalDateTime parse2 = LocalDateTime.parse("2019-02-09T17:03:38.45");
        System.out.println(parse2);

5. Instant类

Instant时间戳/时间线，内部保存了从1970.1.1 00:00:00以来的秒和纳秒的，主要作用也是用来处理秒和纳秒的。
其一般不是给用户用的，而是方便我们程序做一些统计的。

• plusAttribute：增加秒，纳秒
• minusAttribute：减秒，纳秒
• getAttribute：得到秒，纳秒

        Instant now = Instant.now();
        System.out.println(now);  // 2019-02-09T09:08:19.405Z

        Instant plus = now.plusNanos(11);
        Instant minus = now.minusSeconds(11);
        int nano = now.getNano();

6. 计算日期时间差类

Duration/Period类：用于计算日期时间差

• Duration：用于计算两个时间（LocalTime，时分秒）的距离，持续时间
• Period：用于计算两个日期（LocalDate，年月日）的距离，期间

6.1 Duration

        // Duration计算时间距离 to方式
        LocalTime now = LocalTime.now();
        LocalTime localTime = now.plusMinutes(30);
        Duration duration = Duration.between(now, localTime);
        long t = duration.toMinutes();
        System.out.println(t);

6.2 Period

       // Period计算日期距离  get方式
        LocalDate nowDate = LocalDate.now();
        LocalDate localDate = nowDate.plusDays(20);
        Period between = Period.between(nowDate, localDate);
        int days = between.getDays();
        System.out.println(days);

7. 时间矫正器

有时候我们有这样的需求：将日期调整到“下个月的第一天”等操作，可以使用时间矫正器来操作。

• TemporalAdjuster：时间矫正器
• TemporalAdjusters：该类通过静态方法提供了大量的常用TemporalAdjuster的实现。

7.1 自定义时间调整器

        LocalDateTime now = LocalDateTime.now();

        // 时间调整器：得到下个月的第一天
        TemporalAdjuster firstDayOfNextMonth = temporal -> {
            LocalDateTime dateTime = (LocalDateTime)temporal;
            // temporal要调整的时间
            return dateTime.plusMonths(1).withDayOfMonth(1);
        };

        LocalDateTime newDateTime = now.with(firstDayOfNextMonth);
        System.out.println(newDateTime);

7.2 TemporalAdjusters定义好的时间调整器

image.png

        TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstDayOfMonth();
        LocalDateTime newDateTime = now.with(temporalAdjuster);
        System.out.println(newDateTime);

8. 设置日期时间的时区

localDate、localTime、localDateTime是不带时区的，带时区的日期时间类分别是ZonedDate、ZonedTime、ZonedDateTime类。

        // 获取所有的时区id
        // ZoneId.getAvailableZoneIds().forEach(System.out::println);

        // 无时区，默认中国东八区时间
        LocalDateTime now = LocalDateTime.now();
        // 创建计算机默认的时区
        ZonedDateTime now1 = ZonedDateTime.now();
        // 创建世界标准时间
        ZonedDateTime now2 = ZonedDateTime.now(Clock.systemUTC());
        // 使用指定时区创建时间
        ZonedDateTime now3 = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));

        // 修改时区：
        // withZoneSameInstant即更改时区，也更改时间
        // withZoneSameLocal只更改时区，不更改时间
        ZonedDateTime date1 = now2.withZoneSameInstant(ZoneId.of("Asia/ShangHai"));
        ZonedDateTime date2 = now2.withZoneSameLocal(ZoneId.of("Asia/ShangHai"));

9 新旧时间Api对比

• 新版的日期和对象是不可变的，操作的日期不会影响老值，而是新生成一个实例。
• 新的Api提供了两种不同的时间表示方式，有效区分人和机器的不同需求。
• TemporalAdjuster可以更精确的操作日期，还可以自定义日期调整器。
• 线程安全。