Java 8 吸收了 Joda-Time 的精华，以一个新的开始为 Java 创建优秀的 API。新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间
（LocalTime）、本地日期时间（LocalDateTime）、时（ZonedDateTime）和持续时间（Duration）的类。历史悠久的 Date 类新增了 toInstant() 方法，用于把 Date 转换成新的表示形式。这些新增的本地化时间日期 API 大大简化了日期时间和本地化的管理。

1.新时间日期API

• java.time – 包含值对象的基础包
• java.time.chrono – 提供对不同的日历系统的访问
• java.time.format – 格式化和解析时间和日期
• java.time.temporal – 包括底层框架和扩展特性
• java.time.zone – 包含时区支持的类

2.LocalDate、 LocalTime、 LocalDateTime

LocalDate、 LocalTime、 LocalDateTime 类是其中较重要的几个类，它们的实例是不可变的对象，分别表示使用 ISO-8601日历系统的日期、时间、日期和时间。它们提供了简单的本地日期或时间，并不包含当前的时间信息，也不包含与时区相关的信息。

• LocalDate代表IOS格式（yyyy-MM-dd）的日期,可以存储 生日、纪念日等日期。
• LocalTime表示一个时间，而不是日期。
• LocalDateTime是用来表示日期和时间的， 这是一个最常用的类之一。

@Test
        public void test1() {
            //now():获取当前时间，日期，时间+日期
            LocalDate localDate = LocalDate.now();
            LocalTime localTime = LocalTime.now();
            LocalDateTime localDateTime = LocalDateTime.now();

            System.out.println(localDate);
            System.out.println(localTime);
            System.out.println(localDateTime);

            //of()设置指定的年，月，日，时，分，秒，没有偏移量
            LocalDateTime localDateTime1 = LocalDateTime.of(2022, 3, 18, 2, 57, 40);
            System.out.println(localDateTime1);

            //getXxx()
            System.out.println(localDateTime.getDayOfMonth());
            System.out.println(localDateTime.getDayOfWeek());
            System.out.println(localDateTime.getDayOfYear());
            System.out.println(localDateTime.getMonthValue());

            //体现不可变性
            //withXxx():设置相关属性
            LocalDate localDate1 = localDate.withDayOfMonth(22);
            System.out.println(localDate1);
            System.out.println(localDate);

            LocalDateTime localDateTime2 = localDateTime.withHour(4);
            System.out.println(localDateTime);
            System.out.println(localDateTime2);

            //不可变性
            LocalDateTime localDateTime4 = localDateTime.plusMonths(3);
            System.out.println(localDateTime);
            System.out.println(localDateTime4);
        }

3.Instant的使用

Instant：时间线上的一个瞬时点。 这可能被用来记录应用程序中的事件时间戳

@Test
public void test2(){
  Instant instant = Instant.now();
  System.out.println(instant);//2022-03-18T07:28:21.137893500Z
  //添加时间的偏移量
  OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
  System.out.println(offsetDateTime);//2022-03-18T15:33:44.274767100+08:00
  
  //toEpochMilli()获取自1970年1月1日0时0分0秒（UTC）开始的毫秒数
  long milli = instant.toEpochMilli();
  System.out.println(milli);//1647589086176

  //ofEpochMilli():通过给定的毫秒数，获取Instant实例 --->Date(long millis)
  Instant instant1 = Instant.ofEpochMilli(1550475314878L);
  System.out.println(instant);//2022-03-18T07:38:06.176155500Z
}

4.格式化与解析日期或时间

java.time.format.DateTimeFormatter 类：该类提供了三种格式化方法：

• 预定义的标准格式。如：
  ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
• 本地化相关的格式。如： ofLocalizedDateTime(FormatStyle.LONG)
• 自定义的格式。如： ofPattern(“yyyy-MM-dd hh:mm:ss”)
  

public void test3(){
        //方式一： 预定义的标准格式。如：ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
        DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
        //格式化：日期 --->字符串
        LocalDateTime localDateTime = LocalDateTime.now();
        String str1 = formatter.format(localDateTime);

        System.out.println(localDateTime);
        System.out.println(str1);

        //方式二：本地化相关的格式。如： ofLocalizedDateTime
        //FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT:适用于LocalDateTime
        DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT);
        //格式化
        String str2 = formatter1.format(localDateTime);
        System.out.println(str2);//2022/3/18 下午3:55

        //本地化相关的格式。如： ofLocalizedDate
        //FormatStyle.FULL/FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT:适用于LocalDate
        DateTimeFormatter formatter2 = DateTimeFormatter.ofLocalizedDate(FormatStyle.SHORT);
        //格式化
        String str3 = formatter2.format(LocalDate.now());
        System.out.println(str3);//  2022/3/18

        //方式三：自定义的格式。如： ofPattern(“yyyy-MM-dd hh:mm:ss”)

        DateTimeFormatter formatter3 = DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");

        //格式化
        String str4 = formatter3.format(LocalDateTime.now());
        System.out.println(str4);//2022-03-18 04:06:58
    }

5.其它API

• ZoneId： 该类中包含了所有的时区信息， 一个时区的ID， 如 Europe/Paris
• ZonedDateTime： 一个在ISO-8601日历系统时区的日期时间， 如 2007-12-03T10:15:30+01:00 Europe/Paris。
  - 其中每个时区都对应着ID， 地区ID都为“ {区域}/{城市}” 的格式， 例如：Asia/Shanghai等
• Clock： 使用时区提供对当前即时、 日期和时间的访问的时钟。
• 持续时间： Duration， 用于计算两个“时间” 间隔
• 日期间隔： Period， 用于计算两个“日期” 间隔
• TemporalAdjuster : 时间校正器。有时我们可能需要获取例如：将日期调整到“下一个工作日”等操作。
• TemporalAdjusters : 该类通过静态方法
  (firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用
  TemporalAdjuster 的实现。

//ZoneId:类中包含了所有的时区信息
// ZoneId的getAvailableZoneIds():获取所有的ZoneId
Set<String> zoneIds = ZoneId.getAvailableZoneIds();
for (String s : zoneIds) {
System.out.println(s);
}
// ZoneId的of():获取指定时区的时间
LocalDateTime localDateTime = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println(localDateTime);
//ZonedDateTime:带时区的日期时间
// ZonedDateTime的now():获取本时区的ZonedDateTime对象
ZonedDateTime zonedDateTime = ZonedDateTime.now();
System.out.println(zonedDateTime);
// ZonedDateTime的now(ZoneId id):获取指定时区的ZonedDateTime对象
ZonedDateTime zonedDateTime1 = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));
System.out.println(zonedDateTime1);

//Duration:用于计算两个“时间”间隔，以秒和纳秒为基准
LocalTime localTime = LocalTime.now();
LocalTime localTime1 = LocalTime.of(15, 23, 32);
//between():静态方法，返回Duration对象，表示两个时间的间隔
Duration duration = Duration.between(localTime1, localTime);
System.out.println(duration);
System.out.println(duration.getSeconds());
System.out.println(duration.getNano());
LocalDateTime localDateTime = LocalDateTime.of(2016, 6, 12, 15, 23, 32);
LocalDateTime localDateTime1 = LocalDateTime.of(2017, 6, 12, 15, 23, 32);
Duration duration1 = Duration.between(localDateTime1, localDateTime);
System.out.println(duration1.toDays());

//Period:用于计算两个“日期”间隔，以年、月、日衡量
LocalDate localDate = LocalDate.now();
LocalDate localDate1 = LocalDate.of(2028, 3, 18);
Period period = Period.between(localDate, localDate1);
System.out.println(period);
System.out.println(period.getYears());
System.out.println(period.getMonths());
System.out.println(period.getDays());
Period period1 = period.withYears(2);
System.out.println(period1);

// TemporalAdjuster:时间校正器
// 获取当前日期的下一个周日是哪天？
TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
LocalDateTime localDateTime = LocalDateTime.now().with(temporalAdjuster);
System.out.println(localDateTime);
// 获取下一个工作日是哪天？
LocalDate localDate = LocalDate.now().with(new TemporalAdjuster() {
@Override
public Temporal adjustInto(Temporal temporal) {
LocalDate date = (LocalDate) temporal;
if (date.getDayOfWeek().equals(DayOfWeek.FRIDAY)) {
return date.plusDays(3);
} else if (date.getDayOfWeek().equals(DayOfWeek.SATURDAY)) {
return date.plusDays(2);
} else {
return date.plusDays(1);
}
}
});
System.out.println("下一个工作日是： " + localDate);