JDK1.8 新时间日期API学习笔记

Love The Way You Lie 2023-07-08 02:45 17阅读 0赞

**目录**

前言

预备知识

LocalDate、LocalTime、LocalDateTime、Instant

继承关系图

时间对象创建

时间信息获取

时间信息修改

时间格式化(获取指定格式字符串)

时间比较

时间戳（Instant）

计算时间差(Period、Duration、ChronoUnit)

java.time.Period

java.time.Duration

java.time.temporal.ChronoUnit

--------------------

# 前言 #

java8之前我们创建时间new Date或者使用Calendar，很不幸这些类设计的有缺陷，导致使用这些方法写出的代码很容易出错。DateFormat是一个线程不安全的类，在多线程使用会有意想不到的结果出现。在java8中整合了很多Joda-Time的特性。

格式化和解析日期java8提供了线程安全DateTimeFormatter类，创建格式化器最简单的方法时通过它的静态工厂方法及常量。

如果创建简单的时间和日期。java.time包提供了很多新类帮你解决问题，分别是LocalDate、LocalTime、Instant、Duration、Period实现的接口都是TemporalAccessor，这些类都是final类型的，都不能修改。

# 预备知识 #

时间戳(时刻)：所有计算机系统内部都用一个整数表示时刻，这个整数是距离格林尼治标准时间1970年1月1日0时0分0秒的毫秒数，可以理解时刻就是绝对时间，它与时区无关，不同时区对同一时刻的解读，即年月日时分秒是不一样的；时区：同一时刻，世界上各个地区的时间可能是不一样的，具体时间与时区有关，一共有24个时区，英国格林尼治是0时区，北京是东八区，也就是说格林尼治凌晨1点，北京是早上9点；

Instant：表示时间戳(时刻)，不直接对应年月日信息，需要通过时区转换

LocalDateTime: 表示与时区无关的日期和时间信息，不直接对应时刻，需要通过时区转换

LocalDate：表示与时区无关的日期，与LocalDateTime相比，只有日期信息，没有时间信息

LocalTime：表示与时区无关的时间，与LocalDateTime相比，只有时间信息，没有日期信息

ZonedDateTime： 表示特定时区的日期和时间

ZoneId/ZoneOffset：表示时区

![201909011628050.png][]

# LocalDate、LocalTime、LocalDateTime、Instant #

## 继承关系图  ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70][]

LocalDate类获取日期信息。格式为 yyyy-MM-dd 2020-02-20

以下是几种常用的几种生成LocalDate使用方式

## 时间对象创建 ##

//通过工厂模式创建LocalDate 对象  可能常用的几种创建方式
            //获取指定时区的当前时间
            LocalDate shanghaiNow = LocalDate.now(ZoneId.of("Asia/Shanghai"));
            //获取默认时区的当前时间(会调用 Clock.systemDefaultZone() 获取当前操作系统时区)
            LocalDate now = LocalDate.now();
     
            System.out.println("shanghaiNow : "+ shanghaiNow);
            System.out.println("now : "+ now);
            System.out.println("--------------------华丽分割线-----------------------");
     
            //指定年月日生成
            LocalDate yearMonthDay = LocalDate.of(2020, 02, 22);
            System.out.println("yearMonthDay : "+ yearMonthDay);
            System.out.println("--------------------华丽分割线-----------------------");
     
            //通过字符串转换 parse()方法 默认格式为yyyy-MM-dd
            LocalDate charSequenceParse = LocalDate.parse("2020-02-22");
            LocalDate charSequenceParsePattern = LocalDate.parse("2020022210", DateTimeFormatter.ofPattern("yyyyMMddHH"));
     
            System.out.println("charSequenceParse : "+ charSequenceParse);
            System.out.println("charSequenceParsePattern : "+ charSequenceParsePattern);
            System.out.println("--------------------华丽分割线-----------------------");

## 时间信息获取 ##

//获取年月的一些信息的方法
            LocalDate date4Info = LocalDate.of(2020, 02, 22);
            int year = date4Info.getYear(); //当前年
            int monthValue = date4Info.getMonthValue(); //当前月
            int dayOfYear = date4Info.getDayOfYear(); //今年第几天
            int dayOfMonth = date4Info.getDayOfMonth(); //当月第几天
            int dayOfWeekValue = date4Info.getDayOfWeek().getValue(); //当周第几天
     
            System.out.println("year : "+ year);
            System.out.println("monthValue : "+ monthValue);
            System.out.println("dayOfYear : "+ dayOfYear);
            System.out.println("dayOfMonth : "+ dayOfMonth);
            System.out.println("dayOfWeekValue : "+ dayOfWeekValue);
            System.out.println("--------------------华丽分割线-----------------------");

## ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70 1][] ##

## 时间信息修改 ##

//操作  LocalDate的一些方式
            //调整为指定的年月日
            LocalDate date4Adjust = LocalDate.of(2020, 02, 22);
            LocalDate adjustedYearDate = date4Adjust.withYear(2222);
            LocalDate adjustedMonthDate = date4Adjust.withMonth(11);
            LocalDate adjustedMonthDay = date4Adjust.withDayOfMonth(12);
            System.out.println("adjustedYearDate : " + adjustedYearDate);
            System.out.println("adjustedMonthDate : " + adjustedMonthDate);
            System.out.println("adjustedMonthDay : " + adjustedMonthDay);
            System.out.println("adjustedMonthDay : " + adjustedMonthDay);
            System.out.println("--------------------华丽分割线-----------------------");
            // 在对应的 年月日 上 增加指定的时长
            LocalDate plusYears = date4Adjust.plusYears(1);
            LocalDate plusMonths = date4Adjust.plusMonths(1);
            LocalDate plusWeeks = date4Adjust.plusWeeks(1);
            LocalDate plusDays = date4Adjust.plusDays(1);
     
            System.out.println("plusYears : " + plusYears);
            System.out.println("plusMonths : " + plusMonths);
            System.out.println("plusWeeks : " + plusWeeks);
            System.out.println("plusDays : " + plusDays);
            System.out.println("--------------------华丽分割线-----------------------");
     
            // 在对应的 年月日 上 减少指定的时长
            LocalDate minusYears = date4Adjust.minusYears(1);
            LocalDate minusMonths = date4Adjust.minusMonths(1);
            LocalDate minusWeeks = date4Adjust.minusWeeks(1);
            LocalDate minusDays = date4Adjust.minusDays(1);
     
            System.out.println("minusYears : " + minusYears);
            System.out.println("minusMonths : " + minusMonths);
            System.out.println("minusWeeks : " + minusWeeks);
            System.out.println("minusDays : " + minusDays);
            System.out.println("--------------------华丽分割线-----------------------");

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70 2][]

## 时间格式化(获取指定格式字符串) ##

//获取指定格式信息 需要对应时间位存在信息
            LocalDate localDate = LocalDate.of(2020,2,22);
            String yyyyMMssFormatter = localDate.format(DateTimeFormatter.ofPattern("yyyyMMdd"));
            System.out.println(yyyyMMssFormatter);
            //结果 : 20200222

## 时间比较 ##

//两个时间之间的比较
            LocalDate startLocalDate = LocalDate.of(2020, 02, 02);
            LocalDate endLocalDate = LocalDate.of(2021,05,02);
     
            boolean before = startLocalDate.isBefore(endLocalDate);
            boolean after = startLocalDate.isAfter(endLocalDate);

小结 ： LocalTime 以及 LocalDateTime  类操作方式基本相似,或多或少添加了一些对应时间位上的一些操作方法 以及相互之间的转换

## 时间戳（Instant） ##

JDK8获取时间戳特别简单。Instant类由一个静态的工厂方法now()可以返回当前时间戳

当前时间戳是包含日期和时间的，与java.util.Date很类似，事实上Instant就是JDK8以前的Date，可以使用这两个类中的方法在这两个类型之间进行转换。

以及LocalDateTime、LocalDate、LocalTime 与 instant之间的转换

Instant instant = Instant.now(); //2020-02-22T04:50:59.833Z
            Date date = Date.from(instant);//Sat Feb 22 12:50:59 CST 2020
            date.toInstant();
     
            // 将instant 转为 LocalDate LocalTime LocalDateTime 的方式
            instant.atZone(ZoneId.systemDefault()).toLocalDateTime();//2020-02-22T12:56:34.077
            LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, ZoneId.systemDefault());
            
            //将 LocalDate LocalTime LocalDateTime 转为 instant 需要指定时区
            localDateTime.atZone(ZoneId.systemDefault()).toInstant();

# 计算时间差(Period、Duration、ChronoUnit) #

在Java8中，我们可以使用以下类来计算日期时间差异：

## java.time.Period ##

主要是 Period 类方法 getYears()，getMonths() 和 getDays() 来计算。只能精确到年月日。

用于 LocalDate 之间的周期的比较。

LocalDate startLocalDate = LocalDate.of(2020,02,22);
            LocalDate endLocalDate = LocalDate.of(2021,03,25);
            Period period = Period.between(startLocalDate, endLocalDate);
            System.out.printf("相差 : %d 年 %d 月 %d 日",
                    period.getYears(),
                    period.getMonths(),
                    period.getDays());//相差 : 1 年 1 月 3 日

## java.time.Duration ##

提供了使用基于时间的值测量时间量的方法。

用于 LocalDateTime 之间的比较。也可用于 Instant 之间的比较。 LocalTtime 也可以使用 (不能用于LocalDate)

LocalDateTime startLocalDate = LocalDateTime.of(2020,02,29,06,0,0);
            LocalDateTime endLocalDate = LocalDateTime.of(2020,03,02,07,30,0);
            Duration duration = Duration.between(startLocalDate, endLocalDate);
            System.out.println(duration.toDays());//两个时间差的天数        2天
            System.out.println(duration.toHours());//两个时间差的小时数     49小时
            System.out.println(duration.toMinutes());//两个时间差的分钟数   2970分钟
            System.out.println(duration.toMillis());//两个时间差的毫秒数    178200000毫秒
            System.out.println(duration.toNanos());//两个时间差的纳秒数     178200000000000纳秒

## java.time.temporal.ChronoUnit ##

`ChronoUnit类可用于在单个时间单位内测量一段时间，这个工具类是最全的了，可以用于比较所有的时间单位。`

`LocalDate 以及 LocalTime 也可以使用,但是要注意 只能使用对应的时间的类型,如 LocalDate 只能计算 YEARS、MONTHS、DAYS, 而 LocalTime 能计算 HOURS 以下类型的时间差(对应时间位 存在才可计算)`

LocalDateTime startLocalDateTime = LocalDateTime.of(1993,11,05,6,30,0);
            LocalDateTime endLocalDateTime = LocalDateTime.of(2020,2,22,7,50,0);
            //常用
            System.out.println("相差的年数：" + ChronoUnit.YEARS.between(startLocalDateTime, endLocalDateTime)); //相差的年数：26
            System.out.println("相差的月数：" + ChronoUnit.MONTHS.between(startLocalDateTime, endLocalDateTime)); //相差的月数：315
            System.out.println("相差的周数：" + ChronoUnit.WEEKS.between(startLocalDateTime, endLocalDateTime)); //相差的周数：1372
            System.out.println("相差的天数：" + ChronoUnit.DAYS.between(startLocalDateTime, endLocalDateTime));//相差的天数：9605
            System.out.println("相差的时数：" + ChronoUnit.HOURS.between(startLocalDateTime, endLocalDateTime));//相差的时数：230521
            System.out.println("相差的分数：" + ChronoUnit.MINUTES.between(startLocalDateTime, endLocalDateTime));//相差的分数：13831280
            System.out.println("相差的秒数：" + ChronoUnit.SECONDS.between(startLocalDateTime, endLocalDateTime));//相差的秒数：829876800
            System.out.println("相差的毫秒数：" + ChronoUnit.MILLIS.between(startLocalDateTime, endLocalDateTime));//相差的毫秒数：829876800000
            System.out.println("相差的微秒数：" + ChronoUnit.MICROS.between(startLocalDateTime, endLocalDateTime));//相差的微秒数：829876800000000
            System.out.println("相差的纳秒数：" + ChronoUnit.NANOS.between(startLocalDateTime, endLocalDateTime));//相差的纳秒数：829876800000000000
            //不常用
            System.out.println("相差的半天数：" + ChronoUnit.HALF_DAYS.between(startLocalDateTime, endLocalDateTime));//相差的半天数：19210
            System.out.println("相差的十年数：" + ChronoUnit.DECADES.between(startLocalDateTime, endLocalDateTime));//相差的十年数：2
            System.out.println("相差的世纪（百年）数：" + ChronoUnit.CENTURIES.between(startLocalDateTime, endLocalDateTime));//相差的世纪（百年）数：0
            System.out.println("相差的千年数：" + ChronoUnit.MILLENNIA.between(startLocalDateTime, endLocalDateTime));//相差的千年数：0
            System.out.println("相差的纪元数：" + ChronoUnit.ERAS.between(startLocalDateTime, endLocalDateTime));//相差的纪元数：0

[201909011628050.png]: https://img-blog.csdnimg.cn/201909011628050.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20200220180005366.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200222112843548.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200222121551652.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dhbmd4dWVsZWkwMzY=,size_16,color_FFFFFF,t_70