当前位置： 代码迷 >> 综合 >> Java8 LocalDate、LocalTime、LocalDateTime详细使用场景+案例+常用工具类
  详细解决方案

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

热度：69   发布时间：2024-01-09 19:11:31.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);

在这里插入图片描述
通过输出对比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);

在这里插入图片描述

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);

在这里插入图片描述

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

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

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

在这里插入图片描述

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);

在这里插入图片描述

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());

在这里插入图片描述

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);

在这里插入图片描述
可以用同样的方法增加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);

在这里插入图片描述

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!");
}

在这里插入图片描述

10）检查闰年

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

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

在这里插入图片描述

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());

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

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

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

在这里插入图片描述

2、LocalTime类

1）获取当前时间

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

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

在这里插入图片描述

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

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

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

在这里插入图片描述

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);

在这里插入图片描述

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);

在这里插入图片描述

5、Clock类

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

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

在这里插入图片描述

6、Instant类

1）获取当前的时间戳

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

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

在这里插入图片描述

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);

在这里插入图片描述

二、全量代码：

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时钟类//根据系统时间返回当前时间并设置为UTCClock 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);}
}

控制台输出：

在这里插入图片描述

三、总结：

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

  相关解决方案

代码迷 - 您身边的软件异常，代码异常，编程异常助手（发现，解决，分享）
Copyright © 2009-2013 DAIMAMI.COM. All rights reserved.