java8新特性时间操作类 Duration Period和 LocalDateTime LocalDate LocalTime

秒速五厘米 2023-01-03 01:22 125阅读 0赞

# 新的日期API： #

*  LocalDate | -
 *  LocalTime |
 *  LocalDateTime

新的日期API都**是不可变的**，更适用于**多线程**的使用环境中。

## **补充：** 优点 ##

*  表示**日期**的 LocalDate
 *  表示**时间**的 LocalTime
 *  表示**日期时间**的 LocalDateTime

**新的日期API的几个优点：**

*  `之前使用`的java.util.`Date`月份`从0开始`，我们一般会+1使用，
    
     *  `很不方便`，java.time.LocalDate月份和星期都改成了`enum`。
 *  java.util.`Date`和`SimpleDateFormat 都不是线程安全的`，
    
     *  而**LocalDate和LocalTime和最基本的String一样**，**是不变类型**，**不但线程安全**，**而且不能修改**。
 *  java.util.`Date`是一个“**万能接口**”，它包含`日期、时间，还有毫秒数`，**更加明确需求取舍**。
 *  新接口**更好用的原因是**考虑到了**日期时间的操作**，
    
     *  经常发生往前推或往后推几天的情况。
     *  用java.util.Date配合Calendar要写好多代码，而且一般的开发人员还不一定能写对。

# localDateTime #

## localDateTime 获取 年月日 时分秒 ##

@Test
        public void test(){ 
            // 从默认时区的系统时钟获取当前的日期时间。不用考虑时区差
            LocalDateTime date = LocalDateTime.now();122
            //2021-01-04T16:06:10.772186400
            System.out.println(date);                                                                                                             
            //年
            System.out.println(date.getYear());
            //余额
            System.out.println(date.getMonthValue());
            //0 - 31 天
            System.out.println(date.getDayOfMonth());
            //小时
            System.out.println(date.getHour());
            //分钟
            System.out.println(date.getMinute());    
            //秒
            System.out.println(date.getSecond());
            // n. 纳；毫微
            System.out.println(date.getNano());
    
            // 手动创建一个LocalDateTime实例
            LocalDateTime date2 = LocalDateTime.of(2017, 12, 17, 9, 31, 31, 31);
            System.out.println(date2);//2017-12-17T09:31:31.000000031
            // 进行加操作，得到新的日期实例
            LocalDateTime date3 = date2.plusDays(12);
            System.out.println(date3);//2017-12-29T09:31:31.000000031
            // 进行减操作，得到新的日期实例
            LocalDateTime date4 = date3.minusYears(2);
            System.out.println(date4);//2015-12-29T09:31:31.000000031
        }

## 获取当前系统的毫秒值 ##

@Test
        public void test2(){ 
            // 时间戳 1970年1月1日00：00：00 到某一个时间点的毫秒值
            // 默认获取UTC时区
            Instant ins = Instant.now();
            System.out.println(ins);//2021-01-04T08:34:28.178325Z
            //1609749299546
            System.out.println(LocalDateTime.now().toInstant(ZoneOffset.of("+8")).toEpochMilli());
            //Epoch n. [地质] 世；新纪元；新时代；时间上的一点
            System.out.println(System.currentTimeMillis());
    
            System.out.println(Instant.now().toEpochMilli());
            System.out.println(Instant.now().atOffset(ZoneOffset.ofHours(8)).toInstant().toEpochMilli());
    
            /*2021-01-04T08:36:48.636970500Z 1609749408648 1609749408648 1609749408648 1609749408648*/
        }

## Duration 简答使用 获取毫秒 ##

*  Duration:计算两个时间之间的间隔
 *  Period：计算两个日期之间的间隔

@Test
        public void test3(){ 
    
            Instant ins1 = Instant.now();
    
            try { 
                Thread.sleep(1000);
            } catch (InterruptedException e) { 
                e.printStackTrace();
            }
            Instant ins2 = Instant.now();
            Duration dura = Duration.between(ins1, ins2);   
            System.out.println(dura);//PT2.9577809S
            System.out.println(dura.toMillis());//2957毫秒
    
            System.out.println("======================");
            LocalTime localTime = LocalTime.now();
            try { 
                Thread.sleep(1000);
            } catch (InterruptedException e) { 
                e.printStackTrace();
            }
            LocalTime localTime2 = LocalTime.now();
            Duration du2 = Duration.between(localTime, localTime2);
            System.out.println(du2);
            System.out.println(du2.toMillis());
    
            /*PT1.0138602S 1013 ====================== PT1.0028242S 1002*/
        }

## Period 简单使用 获取两个日期中间的天 ##

@Test
        public void test4(){ 
            LocalDate localDate =LocalDate.now();
    
            try { 
                Thread.sleep(1000);
            } catch (InterruptedException e) { 
                e.printStackTrace();
            }
    
            LocalDate localDate2 = LocalDate.of(2021,1,4);
            Period pe = Period.between(localDate, localDate2);
            
            System.out.println(pe.getDays());//如果比 当前时间 多一天，那这里就是1
            System.out.println(pe);
        }

LocalDateTime 的高级使用 获取 下个工作日，一月中的第一天

@Test
        public void test57(){ 
            // temperalAdjust 时间校验器
            // 例如获取下周日 下一个工作日
            LocalDateTime ldt1 = LocalDateTime.now();
            System.out.println(ldt1);
    
            // 获取一年中的第一天
            LocalDateTime ldt2 = ldt1.withDayOfYear(1);
            System.out.println(ldt2);
            // 获取一个月中的第一天
            LocalDateTime ldt3 = ldt1.withDayOfMonth(1);
            System.out.println(ldt3);
    
            LocalDateTime ldt4 = ldt1.with(TemporalAdjusters.next(DayOfWeek.FRIDAY));//这周五是 2021-01-08
            System.out.println(ldt4);
    
            // 获取下一个工作日
            LocalDateTime ldt5 = ldt1.with((t) -> { 
                LocalDateTime ldt6 = (LocalDateTime)t;
                //获取今天是周几
                DayOfWeek dayOfWeek = ldt6.getDayOfWeek();
                //如果是周五 就+3天
                if (DayOfWeek.FRIDAY.equals(dayOfWeek)){ 
                    return ldt6.plusDays(3);
                }
                //周六就+2天
                else if (DayOfWeek.SATURDAY.equals(dayOfWeek)){ 
                    return ldt6.plusDays(2);
                }
                else { 
                    //否则 就+1天
                    return ldt6.plusDays(1);
                }
            });
            //2021-01-06T10:01:30.375872500 下个工作日，就是明天
            System.out.println(ldt5);
        }

## LocalDateTime使用 DateTimeFormatter 格式化 ##

@Test
        public void test6(){ 
            // DateTimeFormatter: 格式化时间/日期
            // 自定义格式
            LocalDateTime ldt = LocalDateTime.now();
            DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日");
            String strDate1 = ldt.format(formatter);
            String strDate = formatter.format(ldt);
            System.out.println(strDate);
            System.out.println(strDate1);
            /*2021年01月05日 2021年01月05日*/
    
            // 使用api提供的格式
            DateTimeFormatter dtf = DateTimeFormatter.ISO_DATE;
            LocalDateTime ldt2 = LocalDateTime.now();
            String strDate3 = dtf.format(ldt2);
            System.out.println(strDate3);//2021-01-05
    
            // 解析字符串to时间
            DateTimeFormatter df = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
            LocalDateTime time = LocalDateTime.now();
            String localTime = df.format(time);
            LocalDateTime ldt4 = LocalDateTime.parse("2017-09-28 17:07:05",df);
            System.out.println("LocalDateTime转成String类型的时间："+localTime);
            System.out.println("String类型的时间转成LocalDateTime："+ldt4);
            /*LocalDateTime转成String类型的时间：2021-01-05 10:13:08 String类型的时间转成LocalDateTime：2017-09-28T17:07:05*/
        }

**LocalDateTime**

public static void localDateTimeTest(){ 
            //转化为时间戳 毫秒值
            long time1 = LocalDateTime.now().toInstant(ZoneOffset.of("+8")).toEpochMilli();
            long time2 = System.currentTimeMillis();
    
            //时间戳转化为localdatetime
            DateTimeFormatter df= DateTimeFormatter.ofPattern("YYYY-MM-dd HH:mm:ss.SSS");
    
            System.out.println(df.format(LocalDateTime.ofInstant(Instant.ofEpochMilli(time1),ZoneId.of("Asia/Shanghai"))));
        }

## LocalDateTime 结合 Zone 简单使用 ##

// ZoneTime ZoneDate ZoneDateTime
        @Test
        public void test7(){ 
            //创建的时候直接指定
            LocalDateTime now = LocalDateTime.now(ZoneId.of("Asia/Shanghai"));
            System.out.println(now);
    		
            //创建后
            LocalDateTime now2 = LocalDateTime.now();
            //在设置 zone
            ZonedDateTime zdt = now2.atZone(ZoneId.of("Asia/Shanghai"));
            System.out.println(zdt);
    
            Set<String> set = ZoneId.getAvailableZoneIds();
            set.stream().forEach(System.out::println);
        }
    
    2021-01-05T16:46:42.388950500
    2021-01-05T16:46:47.736833300+08:00[Asia/Shanghai]
    Asia/Aden

asia 
    英 /ˈeɪʒə; ˈeɪʃə/  美 /ˈeɪʒə/  全球(美国)  
    简明 新牛津  韦氏  例句  百科
    n. 亚洲

# LocalDate #

## **LocalDate** 如何创建 ##

public static void localDateTest() { 
    
            //获取当前日期,只含年月日 固定格式 yyyy-MM-dd 2018-05-04
            LocalDate today = LocalDate.now();
    
            // 根据年月日取日期，5月就是5，
            LocalDate oldDate = LocalDate.of(2018, 5, 1);
    
            // 根据字符串取：默认格式yyyy-MM-dd，02不能写成2
            LocalDate yesteday = LocalDate.parse("2018-05-03");
    
            // 如果不是闰年 传入29号也会报错
            LocalDate.parse("2018-02-29");
        }
    
    //Text '2018-02-29' could not be parsed: Invalid date 'February 29' as '2018' is not a leap year

## **LocalDate常用转化** （高级使用，获取本月的第一天） ##

/** * 日期转换常用,第一天或者最后一天... */
    public static void localDateTransferTest(){ 
        //2018-05-04
        LocalDate today = LocalDate.now();
        // 取本月第1天： 2018-05-01
        LocalDate firstDayOfThisMonth = today.with(TemporalAdjusters.firstDayOfMonth());
        // 取本月第2天：2018-05-02
        LocalDate secondDayOfThisMonth = today.withDayOfMonth(2);
        // 取本月最后一天，再也不用计算是28，29，30还是31： 2018-05-31
        LocalDate lastDayOfThisMonth = today.with(TemporalAdjusters.lastDayOfMonth());
        // 取下一天：2018-06-01
        LocalDate firstDayOf2015 = lastDayOfThisMonth.plusDays(1);
        // 取2018年10月第一个周三 so easy?： 2018-10-03
        LocalDate thirdMondayOf2018 = LocalDate.parse("2018-10-01").with(TemporalAdjusters.firstInMonth(DayOfWeek.WEDNESDAY));
    }

# LocalTime #

## **LocalTime** 创建 ##

@Test
        public void localTimeTest2(){ 
            //16:25:46.448(纳秒值) 17:16:27.163062300
            LocalTime todayTimeWithMillisTime = LocalTime.now();
            //16:28:48 不带纳秒值
            LocalTime todayTimeWithNoMillisTime = LocalTime.now().withNano(0);
            LocalTime time1 = LocalTime.parse("23:59:59");
        }

# [Duration和Period的区别–通俗易懂][Duration_Period] #

在jdk1.8以后，对表示日期时间的类型进行了重新分类，这里出现了2个新的类，Duraction 和Period

*  Duraction表示：时间的区间，用来度量秒和纳秒之间的时间值 。LocalTime
 *  Period表示：一段时间的区间，用来度量年月日和几天之间的时间值。LocalDate

那清楚了这个类度量的时间范围，那么操作api那岂不是易如反掌

如果对LocalDate LocalTime LocalDateTime Instant不熟悉的，可以看[LocalDate LocalTime LocalDateTime Instant的操作与使用][LocalDate LocalTime LocalDateTime Instant]

duration 
    英 /djuˈreɪʃn/  美 /duˈreɪʃn/  全球(美国)  
    简明 牛津 新牛津  韦氏  柯林斯 例句  百科
    n. 持续，持续的时间，期间；音长，音延
    
    Period 
    英 /ˈpɪəriəd/  美 /ˈpɪriəd/  全球(美国)  
    简明 牛津 新牛津  韦氏  柯林斯 例句  百科
    n. 周期，期间；时期；一段时间；经期；课时；句点，句号
    adj. 某一时代的

@Test
        public void test5() { 
            LocalTime localTime = LocalTime.now();
            LocalTime localTime2 = LocalTime.of(19, 19, 19);
            Duration duration = Duration.between(localTime, localTime2);
            System.out.println(duration);
            System.out.println(duration.isZero());            //Duration区间是否为0
            System.out.println(duration.isNegative());        //Duration区间是否为负
    
            System.out.println(duration.getSeconds());        //Duration区间值的秒数
            System.out.println(duration.getNano());            //Duration区间值的纳秒数
            System.out.println(duration.getUnits());        //Duration的度量单位
    
            System.out.println(duration.toDays());            //Duration区间相差几天
            System.out.println(duration.toHours());            //Duration区间差几小时
            System.out.println(duration.toMinutes());        //Duration区间相差几分钟
            System.out.println(duration.toMillis());        //Duration区间相差几毫秒
    
            //============ duration 时间区间的加减 省略 ============
        }

*  秒 纳秒 用 Duration
 *  年月 用 period
 *  其他 两个都有方法

@Test
        public void testPeriod() { 
            LocalDate localDate = LocalDate.now();
            LocalDate localDate2 = LocalDate.of(2021, 12, 12);
            Period period = Period.between(localDate, localDate2);
    
            System.out.println(period);
    
            System.out.println(period.isZero());            //区间是否为0
            System.out.println(period.isNegative());        //区间是否为为负
    
            System.out.println(period.getYears());            //区间的相差几年
            System.out.println(period.getMonths());            //区间的相差几月
            System.out.println(period.getDays());            //区间的相差几日
    
            System.out.println(period.toTotalMonths());        //区间相差多少个月
            //============ duration 时间区间的加减 省略 ============
    
            /*P11M8D false false 0 11 8 11*/
        }

[Duration_Period]: https://www.cnblogs.com/MrRightZhao/p/12005251.html
[LocalDate LocalTime LocalDateTime Instant]: https://www.cnblogs.com/MrRightZhao/p/12005187.html