Java高级编程--JDK8新增的日期时间API

在开发过程中我们常常会碰到要处理时间的需求，前篇介绍了JDK8之前的日期时间API的使用，但是这些API中有很多方法都已经过时了，不再适用或效率不高，难以适应现在的需求，本篇博客将介绍在JDK8中新增的日期时间API的使用。

---

JDK8之前的日期时间API↷传送门

---

目录：

☍ LocalDate、LocalTime、LocalDateTime类

☍ Instant瞬时类

☍ DateTimeFormat格式化与解析类

☍ 其他日期API

---

新日期时间API背景：

JDK 1.0中包含了一个java.util.Date类，但是它的大多数方法已经在JDK 1.1引入Calendar类之后被弃用了。而Calendar并不比Date好多少。它们面临的问题是：

☃ 可变性：对原对象的操作会导致对象发生变化，像日期和时间这样的类应该是不可变的，应该是操作后返回新的对象。

☃ 偏移性：Date中的年份是从1900开始的，而月份都从0开始。

☃ SimpleDateTime格式化只对Date有用，Calendar则不行。

☃ 此外，它们也不是线程安全的；不能处理闰秒等。

Java 8中引入的java.time API 已经纠正了
过去的缺陷，将来很长一段时间内它都会为我们服务。

新的 java.time 中包含了所有关于本地日期（LocalDate）、本地时间（LocalTime）、本地日期时间（LocalDateTime）、时区（ZonedDateTime）和持续时间（Duration）的类。

---

▾ LocalDate、LocalTime、LocalDateTime类

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

➣ LocalDate代表IOS格式（yyyy-MM-dd）的日期：如：2020-06-16

➣ LocalTime表示一个时间，而不是日期，如：08:05:58.464

➣ LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一，如：2020-06-16T08:05:58.464

注：ISO-8601日历系统是国际标准化组织制定的现代公民的日期和时间的表示
法，也就是公历

常用方法：

/**
 * 描述:JDK8中的日期相关API的使用
 *  1、LocalDateTime类相较于LocalDte和LocalTime使用的多一些  (具有类似String的不变性，不改变原对象，返回新的信息)
 *      LocalDateTime.now();   获取当前日期/时间的方法
 *      of(x,y...); 设置日期时间信息
 *      getXxx(); 获取指定信息内容，如年、月、日等
 *      withXxx(value):设置日期时间信息的某个属性，如设置日，设置小时等
 *      plusXxx(value):增加某个属性的值，负数为减  返回新的对象
 */
public void testLocalDateTimeAPI1(){
     /*now()方法，获取当前日期时间信息*/
     System.out.println("-----------now()方法---------");
     LocalDate localDate = LocalDate.now();   //获取当前日期
     LocalTime localTime = LocalTime.now();   //获取当前时间
     LocalDateTime localDateTime = LocalDateTime.now();   //获取当前日期+时间
     System.out.println("LocalDate:" + localDate);    //LocalDate:2020-06-16
     System.out.println("LocalTime:" + localTime);    //LocalTime:08:05:58.464
     System.out.println("localDateTime:" + localDateTime);  //localDateTime:2020-06-16T08:05:58.464

     /*of(x,y...)方法，设置日期时间信息  不变性*/
     System.out.println("-----------of()方法---------");
     LocalDateTime localDateTime1 = LocalDateTime.of(2016,9,01,12,20,18,256);
     System.out.println(localDateTime);  //2020-06-16T08:05:58.464
     System.out.println(localDateTime1);  //2016-09-01T12:20:18.000000256

     /*getXxx()方法，获取指定信息内容，如年月日等*/
     System.out.println("-----------getXxx()方法---------");
     int year = localDate.getYear();
     int month = localDate.getMonthValue();
     int day = localDateTime.getDayOfMonth();
     int hour = localTime.getHour();
     System.out.println("当前日期：" + year + "-" + month + "-" + day + " " + hour + ":"+localTime.getMinute()+":"+localTime.getSecond());
     //当前日期：2020-6-16 8:5:58
        
     /*withXxx(value):设置日期时间信息的某个属性，如设置日，设置小时等*/
     //体现LocalDate,LocalTime,LocalDateTime的不可变性
     System.out.println("-----------withXxx()方法---------");
     LocalDateTime localDateTime2 = localDateTime.withDayOfMonth(8);
     System.out.println(localDateTime1);   //2016-09-01T12:20:18.000000256
     System.out.println(localDateTime2);   //2020-06-08T08:05:58.464

     /*plusXxx(value):增加某个属性的值，负数为减  返回新的对象*/
     System.out.println("-----------plusXxx(value)方法---------");
     LocalDateTime localDateTime3 = localDateTime2.plusYears(1);
     System.out.println(localDateTime3);  //2021-06-08T08:05:58.464

     /*minusXxx(value):减少某个属性的值，负数为加 返回新的对象*/
     System.out.println("-----------minusXxx(value)方法---------");
     LocalDateTime localDateTime4 = localDateTime2.minusYears(1);
     System.out.println(localDateTime4);  //2019-06-08T08:05:58.464
}

---

▾ Instant瞬时类

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

☃ Instant表示时间线上的一点，而不需要任何上下文信息，例如，时区。
概念上讲，它只是简单的表示自1970年1月1日0时0分0秒（UTC）开始的秒
数。

☃ java.time包是基于纳秒计算的，所以Instant的精度可以达到纳秒级。

✦ 1秒 = 1000毫秒 =10^6 微秒=10^9 纳秒

✦ 时间戳是指格林威治时间1970年01月01日 00时00分00秒( 北京时间1970年01月01日08时00分00秒)起至现在的总秒数。

public void testInstant(){
    Instant instant = Instant.now();  //获取本初子午线对应的标准时间
    System.out.println(instant);  //2020-06-13T11:16:44.956Z  和中国时区差将近8小时
    //2020-06-16T00:33:23.768Z
    
    //处理为中国时区:东8区
    OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
    System.out.println(offsetDateTime);   //2020-06-16T08:33:23.768+08:00
    //获取毫秒数  从1970-01-01 00：00：00开始
    Long millis = instant.toEpochMilli();
    System.out.println(millis);  //1592267603768
    System.out.println(new Date().getTime());  //1592267603898
    //将毫秒数转为Instant对象
    Instant instant1 = Instant.ofEpochMilli(1592267462055L);
    System.out.println(instant1.toEpochMilli());  //1592267462055
    //Date --> Instant
    Instant instant2 = new Date().toInstant();
    System.out.println(instant2);   //2020-06-16T00:33:23.898Z
    //Instant --> Date  通过毫秒数
    //LocalDateTime --> Instant
}

---

▾ DateTimeFormat格式化与解析类

DateTimeFormat类格式化方法：

➣ 预定义的标准格式。如：
ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIM，与LocalDateTime、LocalDate、LocalTime类对应

➣ 本地化相关的格式。如：ofLocalizedDateTime(FormatStyle.LONG)

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

public void testDateTimeFormat(){
   //方式一：预定义的标准格式   ISO_LOCAL_DATE_TIME对应LocalDateTime类格式; ISO_LOCAL_DATE对应LocalDate类格式; ISO_LOCAL_TIME对应LocalTime类格式
   DateTimeFormatter dtf = DateTimeFormatter.ISO_LOCAL_DATE;
   //格式化：LocalDateTime/LocalDate/LocalTime --> 字符串
   LocalDateTime localDateTime = LocalDateTime.now();
   System.out.println("localDate:" + localDateTime);   //localDate:2020-06-16T08:43:54.724
   String timeStr1 = dtf.format(localDateTime);
   System.out.println("timeStr1:" + timeStr1);    //timeStr1:2020-06-16
   //解析： 逆过程  字符串 --> TemporalAccessor抽象类
   TemporalAccessor parse1 = dtf.parse(timeStr1);  
   System.out.println("parse1:"+parse1);  //parse1:{},ISO resolved to 2020-06-16

   //方式二：本地化相关的格式。
   //  如：ofLocalizedDateTime()
   //  参数：FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT   适用于LocalDateTime
   //  如：ofLocalizedDate()
   //  参数：FormatStyleFULL/FormatStyle.LONG/FormatStyle.MEDIUM/FormatStyle.SHORT  适用于LocalDate
   DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG);
   //格式化
   String timeStr2 = formatter1.format(localDateTime);
   System.out.println("timeStr2:"+timeStr2);   //timeStr2:2020年6月16日 上午08时43分54秒

   //方式三：自定义格式化格式
   DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy-MM--dd a HH:mm:ss");
   //格式化
   String timeStr3 = formatter2.format(LocalDateTime.now());
   System.out.println("timeStr3:" + timeStr3);   //timeStr3:2020-06--16 上午 08:43:54
   //解析
   TemporalAccessor parse2 = formatter2.parse(timeStr3);
   //TemporalAccessor --> LocalXxx
   LocalDateTime localDateTime1 = LocalDateTime.from(parse2);
   System.out.println("parse2:"+localDateTime1);  //parse2:2020-06-16T08:43:54

   //直接转化字符串，parse(CharSequence text) 或 parse(CharSequence text, DateTimeFormatter formatter）
   LocalDate localDate = LocalDate.parse("2020-06-13");
   System.out.println("localDate:"+localDate);  //localDate:2020-06-13
   LocalDate localDate1 = LocalDate.parse("2020-06-13",DateTimeFormatter.ofPattern("yyyy-MM-dd"));
   System.out.println("localDate1:" + localDate1);   //localDate1:2020-06-13
}

---

▾ 其他日期API

✦ 此部分了解即可，用的时候知道有这些API就行。

​ ☄ ZoneId：该类中包含了所有的时区信息，一个时区的ID，如 Europe/Paris

☄ ZonedDateTime：一个在ISO-8601日历系统时区的日期时间，如 2007-12-03T10:15:30+01:00 Europe/Paris

   ➣ 其中每个时区都对应着ID，地区ID都为“{区域}/{城市}”的格式，例如：
Asia/Shanghai等

​ ☄ Clock：使用时区提供对当前即时、日期和时间的访问的时钟

​ ☄ 日期间隔：Period，用于计算两个“日期”间隔

☄ TemporalAdjuster : 时间校正器。有时我们可能需要获取例如：将日期调整到“下一个工作日”等操作。

 ☄ TemporalAdjusters : 该类通过静态方法(firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用TemporalAdjuster 的实现。

public void otherTimeAPI(){
    //Duration:用于计算两个“时间”间隔，以秒和纳秒为基准
    System.out.println("-------Duration--------");
    LocalTime localTime = LocalTime.now();
    LocalTime localTime1 = LocalTime.of(8, 23, 32);
    System.out.println(localTime + "+++++" + localTime1);  //09:24:37.366+++++08:23:32
    //between():静态方法，返回Duration对象，表示两个时间的间隔
    Duration duration = Duration.between(localTime1, localTime);
    //时间间隔对象Duration
    System.out.println("duration:" + duration);   //duration:PT1H1M5.366S
    //将间隔对象转换为秒
    System.out.println("duration.getSeconds():" + duration.getSeconds());  				     //duration.getSeconds():3665
    //获取秒数小数点后的纳秒级数
    System.out.println("duration.getNano():" + 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(localDateTime, localDateTime1);
    //time1-time2间隔天数
    System.out.println("duration1.toDays():" + duration1.toDays()); //duration1.toDays():365
    System.out.println();

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

    //ZonedDateTime:带时区的日期时间
    // ZonedDateTime的now():获取本时区的ZonedDateTime对象
    System.out.println("------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);
    System.out.println();

    // TemporalAdjuster:时间校正器
    // 获取当前日期的下一个周日是哪天？
    System.out.println("--------TemporalAdjuster----------");
    TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
    LocalDateTime localDateTime3 = LocalDateTime.now().with(temporalAdjuster);
    System.out.println("下一个周日是："+localDateTime3);
    // 获取下一个工作日是哪天？
    LocalDate localDate4 = 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("下一个工作日是：" + localDate4);
    System.out.println();

    //ZoneId:类中包含了所有的时区信息
    // ZoneId的getAvailableZoneIds():获取所有的ZoneId
    System.out.println("-------ZoneId--------");
    Set<String> zoneIds = ZoneId.getAvailableZoneIds();
    for (String s : zoneIds) {
        System.out.println(s);
    }
    // ZoneId的of():获取指定时区的时间
    LocalDateTime localDateTime2 = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
    System.out.println(localDateTime2);
}

---

本博客与CSDN博客༺ཌ༈君☠纤༈ད༻同步发布