Java8新特性：LocalDate、LocalTime、LocalDateTime 使用场景+案例+常用工具类

作者：Albert.Wen 添加时间：2023-04-08 11:29:29 修改时间：2024-04-30 04:36:26 分类：Java基础编辑

简介

在介绍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

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

    }
}

控制台输出：

三、总结：

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日期时间相关工具类

package com.saint.base.util;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoUnit;
import java.util.Date;

/**
 * 本地日期和时间格式化工具
 *
 * @author Saint
 * @version 1.0
 * @createTime 2021-01-08 7:00
 */
public class LocalDateUtil {
    private static final Logger LOGGER = LoggerFactory.getLogger(LocalDateUtil.class);

    /**
     * String类型转LocalDateTime类型
     *
     * @param date    日期字符串
     * @param pattern 日期格式
     * @return LocalDateTime类型
     */
    public static LocalDateTime stringToLocalDateTime(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalDateTime.parse(date, formatter);
    }

    /**
     * String类型转LocalDate类型
     *
     * @param date    日期字符串
     * @param pattern 日期格式
     * @return LocalDate类型
     */
    public static LocalDate stringToLocalDate(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalDate.of(1900, 1, 1);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalDate.parse(date, formatter);
    }

    /**
     * String类型转LocalTime类型
     *
     * @param date    时间字符串
     * @param pattern 时间格式
     * @return LocalTime类型
     */
    public static LocalTime stringToLocalTime(String date, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return LocalTime.of(0, 0, 0);
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return LocalTime.parse(date, formatter);
    }

    /**
     * LocalDateTime类型转String类型
     *
     * @param localDateTime localDateTime类型日期
     * @param pattern       字符串格式
     * @return String类型
     */
    public static String localDateTimeToString(LocalDateTime localDateTime, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return "1900-01-01T00:00:00.000";
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return localDateTime.format(formatter);
    }

    /**
     * LocalDate类型转String类型
     *
     * @param localDate localDate类型日期
     * @param pattern   字符串格式
     * @return String类型
     */
    public static String localDateToString(LocalDate localDate, String pattern) {
        if (pattern == null || "".equals(pattern)) {
            return "1900-01-01";
        }
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
        return localDate.format(formatter);
    }

    /**
     * Date类型转LocalDateTime类型
     *
     * @param date Date类型日期
     * @return LocalDateTime类型
     */
    public static LocalDateTime dateToLocalDateTime(Date date) {
        if (date == null) {
            return LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        Instant instant = date.toInstant();
        // 获取本地时区
        ZoneId zoneId = ZoneId.systemDefault();
        return LocalDateTime.ofInstant(instant, zoneId);
    }

    /**
     * Date类型转LocalDate类型
     *
     * @param date Date类型日期
     * @return LocalDate类型
     */
    public static LocalDate dateToLocalDate(Date date) {
        if (date == null) {
            return LocalDate.of(1900, 1, 1);
        }
        LocalDateTime localDateTime = dateToLocalDateTime(date);
        return localDateTime.toLocalDate();
    }

    /**
     * Date类型转LocalTime类型
     *
     * @param date Date类型日期
     * @return LocalTime类型
     */
    public static LocalTime dateToLocalTime(Date date) {
        if (date == null) {
            return LocalTime.of(0, 0, 0);
        }
        LocalDateTime localDateTime = dateToLocalDateTime(date);
        return localDateTime.toLocalTime();
    }

    /**
     * LocalDateTime类型转Date类型
     *
     * @param localDateTime LocalDateTime类型时间
     * @return Date类型
     */
    public static Date localDateTimeToDate(LocalDateTime localDateTime) {
        if (localDateTime == null) {
            localDateTime = LocalDateTime.of(1900, 1, 1, 0, 0, 0);
        }
        ZoneId zoneId = ZoneId.systemDefault();
        Instant instant = localDateTime.atZone(zoneId).toInstant();
        return Date.from(instant);
    }

    /**
     * LocalDate类型转Date类型
     *
     * @param localDate LocalDate类型日期
     * @return Date类型
     */
    public static Date localDateToDate(LocalDate localDate) {
        if (localDate == null) {
            localDate = LocalDate.of(1900, 1, 1);
        }
        ZoneId zoneId = ZoneId.systemDefault();
        Instant instant = localDate.atStartOfDay().atZone(zoneId).toInstant();
        return Date.from(instant);
    }

    /**
     * LocalTime类型 + LocalDate类型 转Date类型
     *
     * @param localDate LocalDate类型日期
     * @param localTime LocalTime类型时间
     * @return Date类型
     */
    public static Date localTimeToDate(LocalDate localDate, LocalTime localTime) {
        if (localTime == null) {
            return localDateToDate(localDate);
        }
        LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
        return localDateTimeToDate(localDateTime);
    }

    public static LocalDateTime addMonth(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.MONTHS);
    }

    public static LocalDateTime addDay(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.DAYS);
    }

    public static LocalDateTime addHour(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.HOURS);
    }

    public static LocalDateTime addMinute(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.MINUTES);
    }

    public static LocalDateTime addSecond(LocalDateTime time, int interval) {
        return time.plus(interval, ChronoUnit.SECONDS);
    }

    /**
     * 获取两个时间的时间间隔，time2-time1
     *
     * @param time1
     * @param time2
     */
    public static long getIntervalMillisecond(LocalDateTime time1, LocalDateTime time2) {
        return Duration.between(time1, time2).toMillis();
    }

}

摘自：https://blog.csdn.net/Saintmm/article/details/120566578

不灭的焱

革命尚未成功，同志仍须努力下载JDK17

简介