概述

日期时间API的迭代

  • 第一代：jdk 1.0 Date类
  • 第二代：jdk 1.1 Calendar类，一定程度上替换Date类
  • 第三代：jdk 1.8 提出了新的一套API

前两代存在的问题

  • 可变性：像日期和时间这样的类应该是不可变的。
  • 偏移性：Date中的年份是从1900开始的，而月份都从0开始。
  • 格式化：格式化只对Date用，Calendar则不行。

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

    1.       //偏移量
    2.       Date date1 = new Date(2020 - 1900,9 - 1,8);
    3.       System.out.println(date1);//Tue Sep 08 00:00:00 GMT+08:00 2020

    涉及到的包

  • java.time – 包含值对象的基础包

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

LocalDate、LocalTime、LocalDateTime

说明

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

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

  • LocalDateTime是用来表示日期和时间的，这是一个最常用的类之一。

    常用方法

    now() / now(ZoneId zone)静态方法，根据当前时间创建对象/指定时区的对象
    of() 静态方法，根据指定日期/时间创建对象
    getDayOfMonth()/getDayOfYear() 获得月份天数(1-31) /获得年份天数(1-366)
    getDayOfWeek() 获得星期几(返回一个 DayOfWeek 枚举值)
    getMonth() 获得月份, 返回一个 Month 枚举值
    getMonthValue() / getYear() 获得月份(1-12) /获得年份
    getHour()/getMinute()/getSecond() 获得当前对象对应的小时、分钟、秒
    withDayOfMonth()/withDayOfYear()/ withMonth()/withYear() 将月份天数、年份天数、月份、年份修改为指定的值并返回新的对象
    plusDays(), plusWeeks(), plusMonths(), plusYears(),plusHours() 向当前对象添加几天、几周、几个月、几年、几小时
    minusMonths() / minusWeeks()/ minusDays()/minusYears()/minusHours() 从当前对象减去几月、几周、几天、几年、几小时
    ```java //now():获取当前的日期、时间、日期+时间 LocalDate localDate = LocalDate.now(); LocalTime localTime = LocalTime.now(); LocalDateTime localDateTime = LocalDateTime.now();

    System.out.println(localDate);//2022-03-16 System.out.println(localTime);//22:20:11.790 System.out.println(localDateTime);//2022-03-16T22:20:11.790

    //of():设置指定的年、月、日、时、分、秒。没有偏移量 LocalDateTime localDateTime1 = LocalDateTime.of(2020, 10, 6, 13, 23, 43); System.out.println(localDateTime1);//2020-10-06T13:23:43

  1.     //getXxx()：获取相关的属性
  2.     System.out.println(localDateTime.getDayOfMonth());//16
  3.     System.out.println(localDateTime.getDayOfWeek());//WEDNESDAY
  4.     System.out.println(localDateTime.getMonth());//MARCH
  5.     System.out.println(localDateTime.getMonthValue());//3
  6.     System.out.println(localDateTime.getMinute());//20
  8.     //体现不可变性
  9.     //withXxx():设置相关的属性
  10.     LocalDate localDate1 = localDate.withDayOfMonth(22);
  11.     System.out.println(localDate);//2022-03-16
  12.     System.out.println(localDate1);//2022-03-22
  15.     LocalDateTime localDateTime2 = localDateTime.withHour(4);
  16.     System.out.println(localDateTime);//2022-03-16T22:20:11.790
  17.     System.out.println(localDateTime2);//2022-03-16T04:20:11.790
  19.     //不可变性
  20.     LocalDateTime localDateTime3 = localDateTime.plusMonths(3);
  21.     System.out.println(localDateTime);//2022-03-16T22:20:11.790
  22.     System.out.println(localDateTime3);//2022-06-16T22:20:11.790
  24.     LocalDateTime localDateTime4 = localDateTime.minusDays(6);
  25.     System.out.println(localDateTime);//2022-03-16T22:20:11.790
  26.     System.out.println(localDateTime4);//2022-03-10T22:20:11.790
  2. ---
  4. <a name="zsmHq"></a>
  5. # 时间点：Instant
  6. <a name="TKQrq"></a>
  7. ### 说明
  8. ① 时间线上的一个瞬时点。 概念上讲，它只是简单的表示自1970年1月1日0时0分0秒（UTC开始的秒数）<br />② 类似于 java.util.Date类
  9. <a name="QSNaM"></a>
  10. ### 常用方法
  11. `now() `静态方法，返回默认UTC时区的Instant类的对象 <br />`ofEpochMilli(long epochMilli)` 静态方法，返回在1970-01-01 00:00:00基础上加上指定毫秒数之后的Instant类的对象 <br />`atOffset(ZoneOffset offset)` 结合即时的偏移来创建一个 <br />`OffsetDateTime toEpochMilli()` 返回1970-01-01 00:00:00到当前时间的毫秒数，即为时间戳 
  12. ```java
  13.         //now():获取本初子午线对应的标准时间
  14.         Instant instant = Instant.now();
  15.         System.out.println(instant);//2019-02-18T07:29:41.719Z
  17.         //添加时间的偏移量
  18.         OffsetDateTime offsetDateTime = instant.atOffset(ZoneOffset.ofHours(8));
  19.         System.out.println(offsetDateTime);//2019-02-18T15:32:50.611+08:00
  21.         //toEpochMilli():获取自1970年1月1日0时0分0秒（UTC）开始的毫秒数  ---> Date类的getTime()
  22.         long milli = instant.toEpochMilli();
  23.         System.out.println(milli);
  25.         //ofEpochMilli():通过给定的毫秒数，获取Instant实例  -->Date(long millis)
  26.         Instant instant1 = Instant.ofEpochMilli(1550475314878L);
  27.         System.out.println(instant1);

日期时间格式化类：DateTimeFormatter

说明

① 格式化或解析日期、时间
② 类似于SimpleDateFormat

实例化方式

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

常用方法

  • ofPattern(String pattern) 静态方法 ， 返回一个指定字符串格式的DateTimeFormatter
  • format(TemporalAccessor t) 格式化一个日期、时间，返回字符串

  • parse(CharSequence text) 将指定格式的字符序列解析为一个日期、时间
    ```java

    1.    方式一：预定义的标准格式。如：ISO_LOCAL_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIME
    2.   DateTimeFormatter formatter = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
    3.   //格式化:日期-->字符串
    4.   LocalDateTime localDateTime = LocalDateTime.now();
    5.   String str1 = formatter.format(localDateTime);
    6.   System.out.println(localDateTime);
    7.   System.out.println(str1);//2019-02-18T15:42:18.797
    9.   //解析：字符串 -->日期
    10.   TemporalAccessor parse = formatter.parse("2019-02-18T15:42:18.797");
    11.   System.out.println(parse);

// 方式二： // 本地化相关的格式。如：ofLocalizedDateTime() // FormatStyle.LONG / FormatStyle.MEDIUM / FormatStyle.SHORT :适用于LocalDateTime DateTimeFormatter formatter1 = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG); //格式化 String str2 = formatter1.format(localDateTime); System.out.println(str2);//2019年2月18日 下午03时47分16秒

// 本地化相关的格式。如：ofLocalizedDate() // FormatStyle.FULL / FormatStyle.LONG / FormatStyle.MEDIUM / FormatStyle.SHORT : 适用于LocalDate DateTimeFormatter formatter2 = DateTimeFormatter.ofLocalizedDate(FormatStyle.MEDIUM); //格式化 String str3 = formatter2.format(LocalDate.now()); System.out.println(str3);//2019-2-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);//2019-02-18 03:52:09

  1.     //解析
  2.     TemporalAccessor accessor = formatter3.parse("2019-02-18 03:52:09");
  3.     System.out.println(accessor);
  2. ---
  4. <a name="IeWkd"></a>
  5. #  其它API 
  6. <a name="Kygt5"></a>
  7. ### 带时区的日期时间：ZonedDateTime / ZoneId 
  8. ```java
  9. // ZoneId:类中包含了所的时区信息
  10.     @Test
  11.     public void test1(){
  12.         //getAvailableZoneIds():获取所的ZoneId
  13.         Set<String> zoneIds = ZoneId.getAvailableZoneIds();
  14.         for(String s : zoneIds){
  15.             System.out.println(s);
  16.         }
  17.         System.out.println();
  19.         //获取“Asia/Tokyo”时区对应的时间
  20.         LocalDateTime localDateTime = LocalDateTime.now(ZoneId.of("Asia/Tokyo"));
  21.         System.out.println(localDateTime);
  24.     }
  25. //ZonedDateTime:带时区的日期时间
  26.     @Test
  27.     public void test2(){
  28.         //now():获取本时区的ZonedDateTime对象
  29.         ZonedDateTime zonedDateTime = ZonedDateTime.now();
  30.         System.out.println(zonedDateTime);
  31.         //now(ZoneId id):获取指定时区的ZonedDateTime对象
  32.         ZonedDateTime zonedDateTime1 = ZonedDateTime.now(ZoneId.of("Asia/Tokyo"));
  33.         System.out.println(zonedDateTime1);
  34.     }

时间间隔：Duration—用于计算两个“时间”间隔，以秒和纳秒为基准

image.png

  1. @Test
  2.     public void test3(){
  3.         LocalTime localTime = LocalTime.now();
  4.         LocalTime localTime1 = LocalTime.of(15, 23, 32);
  5.         //between():静态方法，返回Duration对象，表示两个时间的间隔
  6.         Duration duration = Duration.between(localTime1, localTime);
  7.         System.out.println(duration);
  9.         System.out.println(duration.getSeconds());
  10.         System.out.println(duration.getNano());
  12.         LocalDateTime localDateTime = LocalDateTime.of(2016, 6, 12, 15, 23, 32);
  13.         LocalDateTime localDateTime1 = LocalDateTime.of(2017, 6, 12, 15, 23, 32);
  15.         Duration duration1 = Duration.between(localDateTime1, localDateTime);
  16.         System.out.println(duration1.toDays());
  18.     }

日期间隔：Period —用于计算两个“日期”间隔，以年、月、日衡量

image.png

  1. @Test
  2.     public void test4(){
  3.         LocalDate localDate = LocalDate.now();
  4.         LocalDate localDate1 = LocalDate.of(2028, 3, 18);
  6.         Period period = Period.between(localDate, localDate1);
  7.         System.out.println(period);
  9.         System.out.println(period.getYears());
  10.         System.out.println(period.getMonths());
  11.         System.out.println(period.getDays());
  13.         Period period1 = period.withYears(2);
  14.         System.out.println(period1);
  16.     }

日期时间校正器：TemporalAdjuster

  1.     @Test
  2.     public void test5(){
  3.         //获取当前日期的下一个周日是哪天？
  4.         TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(DayOfWeek.SUNDAY);
  6.         LocalDateTime localDateTime = LocalDateTime.now().with(temporalAdjuster);
  7.         System.out.println(localDateTime);
  9.         //获取下一个工作日是哪天？
  10.         LocalDate localDate = LocalDate.now().with(new TemporalAdjuster(){
  12.             @Override
  13.             public Temporal adjustInto(Temporal temporal) {
  14.                 LocalDate date = (LocalDate)temporal;
  15.                 if(date.getDayOfWeek().equals(DayOfWeek.FRIDAY)){
  16.                     return date.plusDays(3);
  17.                 }else if(date.getDayOfWeek().equals(DayOfWeek.SATURDAY)){
  18.                     return date.plusDays(2);
  19.                 }else{
  20.                     return date.plusDays(1);
  21.                 }
  23.             }
  25.         });
  27.         System.out.println("下一个工作日是：" + localDate);
  28.     }