Java8 LocalDate、LocalTime、LocalDateTime详细使用场景+案例+常用工具类

矫情吗；* 2023-10-02 09:15 37阅读 0赞

### 简介 ###

在介绍Java8处理日期的方式之前，我们先聊一下Java8之前处理日期、日历和时间的**不足之处**：

*  java.util.Date是可变类型；
 *  SimpleDateFormat是非线程安全的，是的应用会受一定的限制。

**Java8时间类型的好处：**

*  明确了日期、时间概念；例如：瞬时（instant）、 长短（duration）、日期、时间、时区和周期。
 *  继承了Joda 库按人类语言和计算机各自解析的时间处理方式。
 *  新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全

#### 关键类： ####

*  Instant：瞬时实例。
 *  LocalDate：本地日期，不包含具体时间 例如：2014-01-14 可以用来记录生日、纪念日、加盟日等。
 *  LocalTime：本地时间，不包含日期。
 *  LocalDateTime：组合了日期和时间，但不包含时差和时区信息。
 *  ZonedDateTime：最完整的日期时间，包含时区和相对UTC或格林威治的时差。
 *  ZoneOffSet 和 ZoneId 类，使得解决时区问题更为简便。
 *  DateTimeFormatter 类，解析、格式化时间也全部重新设计。

### 一、实战 ###

#### 1、LocalDate ####

##### 1）获取当前日期 #####

Java 8 中的 LocalDate 用于表示当天日期。和 java.util.Date不同，它只有日期，不包含时间。

//1）获取今天的日期
    LocalDate today = LocalDate.now();
    System.out.println("Today's local data : " + today);
    //使用Date获取今天的日期
    Date date = new Date();
    System.out.println(date);

![在这里插入图片描述][bee8d5516d824e99bdfbcae5094b71d0.png]  
通过输出对比Date我们发现：Java8的LocalDate打印出的日期格式非常友好，不像 Date类 打印出一堆没有格式化的信息。

##### 2）获取年、月、日信息 #####

LocalDate 提供了获取年、月、日的快捷方法，其实例还包含很多其它的日期属性。通过调用这些方法就可以很方便的得到需要的日期信息，不用像以前一样需要依赖java.util.Calendar类了。

//2）获取年、月、日信息
    int year = today.getYear();
    int month = today.getMonthValue();
    int day = today.getDayOfMonth();
    System.out.printf("Year: %d, Month: %d, Day: %d。 %n ", year, month, day);

![在这里插入图片描述][fb478727d7424088a7cb5fa999b055d9.png]

##### 3）创建特定的日期 #####

我们可以调用工厂方法 `LocalDate.of()`创建任意日期， 该方法需要传入年、月、日做参数，返回对应的LocalDate实例。  
**好处：**

*  这个方法没再犯老API的设计错误，比如年度起始于1900，月份是从 0 开始等等。日期所见即所得，就像下面这个例子表示了6月26日，直接明了。

//3）创建特定日期
    LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
    System.out.println("The special date is: " + dateOfBirth);

![在这里插入图片描述][3b938e28003e457db68fa01a6ae01b4e.png]

##### 4）判断两个日期是否相等 #####

在项目开发过程中，经常会遇到这个需求，LocalDate重载了equal方法。  
`注：如果比较的日期是字符型的，需要先解析成日期对象再作判断。`

//4）判断两个日期是否相等
     boolean equal = today.equals(dateOfBirth);
     System.out.println("是今天？ " + equal);

![在这里插入图片描述][ee0689ccc2aa4576bdcde2bf3b8551fc.png]

##### 5）检查像生日这种周期性事件 #####

Java 中另一个日期时间的处理就是检查类似生日、纪念日、法定假日（国庆以及春节）、或者每个月固定时间发送邮件给客户 这些周期性事件。  
MonthDay类组合了月份和日，我们可以用它判断每年都会发生的事件。  
还有一个类似的YearMonth类，这个类也都是不可变并且线程安全的值类型。

//5）检查像生日这种周期性事件
    LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
    MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
    MonthDay currentMonthDay = MonthDay.now();
    boolean happen = currentMonthDay.equals(birthday);
    System.out.println("生日到了？ " + happen);

![在这里插入图片描述][ca82c05e51e6433ca54863e6f2942b7e.png]

##### 6）处理固定日期 #####

与 `MonthDay` 检查重复事件的例子相似，`YearMonth` 是另一个组合类，用于表示信用卡到期日、FD到期日、期货期权到期日等。还可以用这个类得到 当月共有多少天，YearMonth 实例的 lengthOfMonth() 方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

// YearMonth 固定日期，lengthOfMonth用来获取一月有几天
    YearMonth currentYearMonth = YearMonth.now();
    System.out.printf("%s have %d days. %n", currentYearMonth, currentYearMonth.lengthOfMonth());

![在这里插入图片描述][b9edcc63accc48bc9444762bee0e0c92.png]

##### 7）计算一个星期之后的日期 #####

LocalDate日期不包含时间信息，它的plus()方法用来增加天、周、月；ChronoUnit类声明了这些时间单位。  
`注意：由于LocalDate也是不变类型，返回后一定要用变量赋值`。

//8）计算一周后的日期,LocalDate的plus方法增加天数、周数或者月数。
    LocalDate today = LocalDate.now();
    LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
    System.out.println("Today is: " + today);
    System.out.println("Date after 1 week: " + nextWeek);

![在这里插入图片描述][39637c8e330f4f50946414dcb61ef8d9.png]  
可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪，更多选项可以查看Java 8 API中的ChronoUnit类。

##### 8）获取一年之前的日期 #####

我们利用 minus() 方法计算一年前的日期。

//9）计算一年前的日期
    LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
    System.out.println("Date before 1 year: " + previousYear);

![在这里插入图片描述][63a4c70c30d04806b5313e96c299e5d5.png]

##### 9）判断日期是早于还是晚于另一个日期 #####

LocalDate 类有两类方法 isBefore() 和 isAfter() 用于比较日期。调用 isBefore() 方法时，如果给定日期小于当前日期则返回 true。

LocalDate today = LocalDate.now();
    LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS);
    if (tomorrow.isAfter(today)) {
        
        System.out.println("Tomorrow comes after today!");
    }

![在这里插入图片描述][a458b0e8982e4de0ac522f6d8f6133b2.png]

##### 10）检查闰年 #####

LocalDate类有一个很实用的方法 `isLeapYear()` 判断该实例是否是一个闰年。

LocalDate today = LocalDate.now();
    boolean isLeapYear = today.isLeapYear();
    System.out.println("今年是闰年吗？" + isLeapYear);

![在这里插入图片描述][aa512384653244b985030f7a2a315f65.png]

##### 11）计算两个日期之间的天数和月数 #####

Java 8中可以用java.time.Period类用来计算两个日期之间的天数、周数或月数。

LocalDate today = LocalDate.now();
    LocalDate java8time = LocalDate.of(2019, Month.AUGUST, 31);
    Period period = Period.between(java8time, today);
    System.out.printf("从2019年8月31到现在过去了 %d 个月。\n", period.getMonths());

![在这里插入图片描述][df3ee6abf26648c1a689dffa6875ce5d.png]  
卧槽，什么情况，从2019年8月31到现在（2021-09-30）过去了 0 个月。

我们debug看一下：原来`period参数中的组成是年、月、日`  
![在这里插入图片描述][e130271aecb0479fa162ae863f0a1222.png]  
我们将获取到的相差的年数 \* 12 再加上月数就好了撒。

int periodMonth = period.getYears() * 12 + period.getMonths();
    System.out.printf("修正版：从2019年8月31到现在过去了 %d 个月。\n", periodMonth);

![在这里插入图片描述][c01367d72ceb49f59e534a3e439a628e.png]

#### 2、LocalTime类 ####

##### 1）获取当前时间 #####

使用 LocalTime 类获取时间，和只能获取到日期的LocalDate类似。通过调用静态工厂方法now()可以获取当前时间，默认时间格式化为：hh:mm:ss:nnn

//6）获取当前时间
    LocalTime time = LocalTime.now();
    System.out.println("Local time now: " + time);

![在这里插入图片描述][bc4aabef7c114516a0b2dd21a6d553e2.png]

##### 2）在现有的时间上增加小时 #####

Java 8 提供了更好的 plusHours() 方法替换 add() ，并且是兼容的。  
`注：这些方法返回一个全新的LocalTime实例，由于其不可变性，返回后一定要用变量赋值`。

//7）在现有的时间上增加小时
    LocalTime time = LocalTime.now();
    LocalTime newTime = time.plusHours(2);
    System.out.println("Time after 2 hours: " + newTime);

![在这里插入图片描述][9d8d04275aa1442f9ce043f9ca6f43cf.png]

#### 3、LocalDateTime类 ####

##### 1）包含时差信息的日期和时间 #####

ZoneOffset类用来表示时区，举例来说印度与GMT或UTC标准时区相差+05:30，可以通过`ZoneOffset.of()`静态方法来 获取对应的时区。一旦得到了时差就可以通过传入LocalDateTime和ZoneOffset来创建一个OffSetDateTime对象

LocalDateTime dateTime = LocalDateTime.of(2020, Month.JANUARY, 10, 11, 11);
    //时差加上5个半小时
    ZoneOffset offset = ZoneOffset.of("+05:30");
    OffsetDateTime offsetDateTime = OffsetDateTime.of(dateTime, offset);
    System.out.println("2020-1-10 11:11 加上5个半小时时差后的北京时间为：" + offsetDateTime);

![在这里插入图片描述][5aa23c6b39d34156852f26db10bbd422.png]

#### 4、ZoneDateTime类 ####

##### 1）处理时区 #####

处理时区Java 8不仅分离了日期和时间，也把时区分离出来了。现在有一系列单独的类如 ZoneId 来处理特定时区，ZoneDateTime 类来表示某时区下的时间。

//使用ZoneId处理特定的时区
    ZoneId america = ZoneId.of("America/New_York");
    LocalDateTime localDateTime = LocalDateTime.now();
    ZonedDateTime zonedDateTimeInNewYork = ZonedDateTime.of(localDateTime, america);
    System.out.println("现在的日期和时间再特定的时区是：" + zonedDateTimeInNewYork);

![在这里插入图片描述][471a01f92fef42d8bd2fe5ba677a4bcf.png]

#### 5、Clock类 ####

Java 8增加了一个 Clock 时钟类用于获取当时的时间戳，或当前时区下的日期时间信息。以前用到System.currentTimeInMillis() 和 TimeZone.getDefault() 的地方都可用Clock替换。

//10）Java8的Clock时钟类
    //根据系统时间返回当前时间并设置为UTC
    Clock clock = Clock.systemUTC();
    System.out.println("Clock: " + clock);

![在这里插入图片描述][8fe2f523ef0a4a858575d0956fd05c6c.png]

#### 6、Instant类 ####

##### 1）获取当前的时间戳 #####

Instant类有一个静态工厂方法now()会返回当前的时间戳。

Instant timestamp = Instant.now();
    System.out.println("What is value of this instant：" + timestamp);

![在这里插入图片描述][9a710702e56e4a76a005f048bf213ced.png]

#### 7、DateTimeFormatter类 ####

##### 1）使用预定义的格式化工具去解析或格式化日期 #####

Java 8引入了全新的日期时间格式工具，线程安全而且使用方便。它自带了一些常用的内置格式化工具。  
下面这个例子使用了BASIC\_ISO\_DATE格式化工具将20200628格式化成2020年6月28日。

String dayAfterTomorrow = "20200628";
    LocalDate formatted = LocalDate.parse(dayAfterTomorrow, DateTimeFormatter.BASIC_ISO_DATE);
    System.out.printf("Date generated from String %s is %s. %n", dayAfterTomorrow, formatted);

![在这里插入图片描述][183bcf59c0274d02aa2550bc9b0499ff.png]

### 二、全量代码： ###

package com.saint.base.localdate;
    
    import java.time.*;
    import java.time.format.DateTimeFormatter;
    import java.time.temporal.ChronoUnit;
    import java.util.Date;
    
    /**
     * @author Saint
     */
    public class CurrentDate {
        
        public static void main(String[] args) {
        
            //1）获取今天的日期
            LocalDate today = LocalDate.now();
            System.out.println("Today's local data : " + today);
            //使用Date获取今天的日期
            Date date = new Date();
            System.out.println(date);
    
            //2）获取年、月、日信息
            int year = today.getYear();
            int month = today.getMonthValue();
            int day = today.getDayOfMonth();
            System.out.printf("Year: %d, Month: %d, Day: %d。 %n ", year, month, day);
    
            //3）创建特定日期
            LocalDate dateOfBirth = LocalDate.of(2019, 06, 26);
            System.out.println("The special date is: " + dateOfBirth);
    
            //4）判断两个日期是否相等
            boolean equal = today.equals(dateOfBirth);
            System.out.println("是今天？ " + equal);
    
            //5）检查像生日这种周期性事件
            MonthDay birthday = MonthDay.of(dateOfBirth.getMonth(), dateOfBirth.getDayOfMonth());
            MonthDay currentMonthDay = MonthDay.now();
            boolean happen = currentMonthDay.equals(birthday);
            System.out.println("生日到了？ " + happen);
    
            //6）获取当前时间
            LocalTime time = LocalTime.now();
            System.out.println("Local time now: " + time);
    
            //7）在现有的时间上增加小时
            LocalTime newTime = time.plusHours(2);
            System.out.println("Time after 2 hours: " + newTime);
    
            //8）计算一周后的日期,LocalDate的plus方法增加天数、周数或者月数。
            LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
            System.out.println("Today is: " + today);
            System.out.println("Date after 1 week: " + nextWeek);
    
            //9）计算一年前的日期
            LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
            System.out.println("Date before 1 year: " + previousYear);
    
            //10）Java8的Clock时钟类
            //根据系统时间返回当前时间并设置为UTC
            Clock clock = Clock.systemUTC();
            System.out.println("Clock: " + clock);
    
            //11）判断日期是早于还是晚于另一个日期
            LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS);
            if (tomorrow.isAfter(today)) {
        
                System.out.println("Tomorrow comes after today!");
            }
    
            //12）处理时区，Java8不仅分离了日期和时间，也把时区分离出来了。
            //使用ZoneId处理特定的时区
            ZoneId america = ZoneId.of("America/New_York");
            LocalDateTime localDateTime = LocalDateTime.now();
            ZonedDateTime zonedDateTimeInNewYork = ZonedDateTime.of(localDateTime, america);
            System.out.println("现在的日期和时间再特定的时区是：" + zonedDateTimeInNewYork);
    
            //13）YearMonth 固定日期，lengthOfMonth用来获取一月有几天
            YearMonth currentYearMonth = YearMonth.now();
            System.out.printf("%s have %d days. %n", currentYearMonth, currentYearMonth.lengthOfMonth());
    
            //14）检查闰年
            boolean isLeapYear = today.isLeapYear();
            System.out.println("今年是闰年吗？" + isLeapYear);
    
            //15）计算两个日期之间的天数和月数
            LocalDate java8time = LocalDate.of(2019, Month.AUGUST, 31);
            Period period = Period.between(java8time, today);
            System.out.printf("从2019年8月31到现在过去了 %d 个月。\n", period.getMonths());
            int periodMonth = period.getYears() * 12 + period.getMonths();
            System.out.printf("修正版：从2019年8月31到现在过去了 %d 个月。\n", periodMonth);
    
            //16）包含时差信息的日期和时间
            LocalDateTime dateTime = LocalDateTime.of(2020, Month.JANUARY, 10, 11, 11);
            //时差加上5个半小时
            ZoneOffset offset = ZoneOffset.of("+05:30");
            OffsetDateTime offsetDateTime = OffsetDateTime.of(dateTime, offset);
            System.out.println("2020-1-10 11:11 加上5个半小时时差后的北京时间为：" + offsetDateTime);
    
            //17）获取当前的时间戳
            Instant timestamp = Instant.now();
            System.out.println("What is value of this instant：" + timestamp);
    
            //18）使用预定义的格式化工具去解析或格式化日期
            String dayAfterTomorrow = "20200628";
            LocalDate formatted = LocalDate.parse(dayAfterTomorrow, DateTimeFormatter.BASIC_ISO_DATE);
            System.out.printf("Date generated from String %s is %s. %n", dayAfterTomorrow, formatted);
    
        }
    }

#### 控制台输出： ####

![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5qKm5Zue546W5p-S_size_20_color_FFFFFF_t_70_g_se_x_16]

### 三、总结： ###

Java8日期时间API的重点：

*  提供了javax.time.ZoneId获取时区。
 *  提供了LocalDate和LocalTime类。
 *  Java8 的所有日期和时间API都是不可变类并且是`线程安全`的，而现有的Date和Calendar API中的java.util.Date和`SimpleDateFormat`是`非线程安全`的。
 *  java.time的子包`java.time.format`用于`格式化`， `java.time.temporal`用于`更底层`的操作。
 *  时区代表了地球上某个区域内普遍使用的标准时间。每个时区都有一个代号。  
    `格式`通常由`区域/城市`构成（Asia/Tokyo），再加上与格林威治或UTC的`时差`。例如：东京的时差是+09:00。

### 四、Local日期时间相关工具类 ###

[https://blog.csdn.net/Saintmm/article/details/120566578][https_blog.csdn.net_Saintmm_article_details_120566578]

[bee8d5516d824e99bdfbcae5094b71d0.png]: https://img-blog.csdnimg.cn/bee8d5516d824e99bdfbcae5094b71d0.png
[fb478727d7424088a7cb5fa999b055d9.png]: https://img-blog.csdnimg.cn/fb478727d7424088a7cb5fa999b055d9.png
[3b938e28003e457db68fa01a6ae01b4e.png]: https://img-blog.csdnimg.cn/3b938e28003e457db68fa01a6ae01b4e.png
[ee0689ccc2aa4576bdcde2bf3b8551fc.png]: https://img-blog.csdnimg.cn/ee0689ccc2aa4576bdcde2bf3b8551fc.png
[ca82c05e51e6433ca54863e6f2942b7e.png]: https://img-blog.csdnimg.cn/ca82c05e51e6433ca54863e6f2942b7e.png
[b9edcc63accc48bc9444762bee0e0c92.png]: https://img-blog.csdnimg.cn/b9edcc63accc48bc9444762bee0e0c92.png
[39637c8e330f4f50946414dcb61ef8d9.png]: https://img-blog.csdnimg.cn/39637c8e330f4f50946414dcb61ef8d9.png
[63a4c70c30d04806b5313e96c299e5d5.png]: https://img-blog.csdnimg.cn/63a4c70c30d04806b5313e96c299e5d5.png
[a458b0e8982e4de0ac522f6d8f6133b2.png]: https://img-blog.csdnimg.cn/a458b0e8982e4de0ac522f6d8f6133b2.png
[aa512384653244b985030f7a2a315f65.png]: https://img-blog.csdnimg.cn/aa512384653244b985030f7a2a315f65.png
[df3ee6abf26648c1a689dffa6875ce5d.png]: https://img-blog.csdnimg.cn/df3ee6abf26648c1a689dffa6875ce5d.png
[e130271aecb0479fa162ae863f0a1222.png]: https://img-blog.csdnimg.cn/e130271aecb0479fa162ae863f0a1222.png
[c01367d72ceb49f59e534a3e439a628e.png]: https://img-blog.csdnimg.cn/c01367d72ceb49f59e534a3e439a628e.png
[bc4aabef7c114516a0b2dd21a6d553e2.png]: https://img-blog.csdnimg.cn/bc4aabef7c114516a0b2dd21a6d553e2.png
[9d8d04275aa1442f9ce043f9ca6f43cf.png]: https://img-blog.csdnimg.cn/9d8d04275aa1442f9ce043f9ca6f43cf.png
[5aa23c6b39d34156852f26db10bbd422.png]: https://img-blog.csdnimg.cn/5aa23c6b39d34156852f26db10bbd422.png
[471a01f92fef42d8bd2fe5ba677a4bcf.png]: https://img-blog.csdnimg.cn/471a01f92fef42d8bd2fe5ba677a4bcf.png
[8fe2f523ef0a4a858575d0956fd05c6c.png]: https://img-blog.csdnimg.cn/8fe2f523ef0a4a858575d0956fd05c6c.png
[9a710702e56e4a76a005f048bf213ced.png]: https://img-blog.csdnimg.cn/9a710702e56e4a76a005f048bf213ced.png
[183bcf59c0274d02aa2550bc9b0499ff.png]: https://img-blog.csdnimg.cn/183bcf59c0274d02aa2550bc9b0499ff.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBA5qKm5Zue546W5p-S_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/24d588ca08a44fa2af6e71b4e1699631.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA5qKm5Zue546W5p-S,size_20,color_FFFFFF,t_70,g_se,x_16
[https_blog.csdn.net_Saintmm_article_details_120566578]: https://blog.csdn.net/Saintmm/article/details/120566578