技术经验｜Java基础之LocalDate类

原创

Aion

发布于 2023-11-12 20:28:12

2580

发布于 2023-11-12 20:28:12

1 背景

Java里的日期和时间格式化问题，在JDK8（Java SE Development Kit8，以下使用过程中，均称为JDK1.8或者JDK8）以前有很多问题，例如日期类并不提供国际化，没有时区支持，包分配的也比较混乱。所以在JDK8后进行了大改造，索性在rt.jar中新增了一个time包，这样我们就可以个性化设置日期时间的展示方式了。

目前JDK已经到达了JDK 21(Java Development Kit 21)，但是在主流的市场上面，使用JDK8的居多。我们现在已经掌握了不少关于日期和时间的操作技巧，但其实随着时间的不断推移，现实的需求也在不断更新，原先的一些API已经难以满足开发需求了。所以从JDK 8之后，为了满足更多的开发需求，Java给我们增加了不少关于日期时间的新特性，接下来本篇文章就带各位来看看这些新特性有哪些。

2 Time包的位置

2.1 Time包在架构中位置

从官网上面的介绍，我们可以看到，新版本的JDK8包括两个实现Java平台标准版（JavaSE）8的产品：JavaSE开发工具包（JDK）8和JavaSE运行时环境（JRE）8。其中JDK8包含了JRE8的所有内容，官网按级别对Java组件技术进行了分类。下面从上到下列出了这些级别，以及每个级别的技术。属于较低级别的技术是属于较高级别的技术的基础。从图中可以看到，Time包所在目录为基础库中的Date and Time文件夹下。

2.2 Time包在实际开发中的位置

Time API是一组对日期和时间的最重要方面进行建模的包。java. time包中的核心类使用ISO-8601中定义的日历系统（基于公历系统）作为默认日历。当我们引入JDK8后，可以在rt.jar中的java.time目录下找到对应的基础API，打开可以看到有很多新引入的包和类。功能虽多，但是常用的也就是那么几个，所以你想要尽快熟悉，可以自行点击进去查阅。

2.3 Time下主要基础类

从代码API中，我么可以看到有很多类API，大体分为如下功能点：

本地日期和时间类：LocalDate，LocalDateTime，LocalTime；
带时区的日期和时间类：ZonedDateTime；
时钟、时刻类：Clock、Instant；
时区：ZoneId，ZoneOffset；
某个时期、时间间隔：Period、Duration。

此外，API还提供了两个枚举类：DayOfWeek和Week。今天主要想说说LocalDate这个类。

3 本地日期和时间类

3.1 LocalDate自带功能

API说明，LocalDate自己的方法或功能没有多少，多数都是实现了Temporal, TemporalAdjuster, ChronoLocalDate这三个类。

测试代码如下：

public static void main(String[] args) {

        System.out.println("-- LocalDate自带API功能");
        // 当前日期
        System.out.println("LocalDate.now() = " + LocalDate.now());
        // 衍生出来两个方法，其中一个是从时区获取当前日期，另外一个是从从时钟方式获取
        System.out.println("LocalDate.now(ZoneId.of('Asia/Shanghai')) = " + LocalDate.now(ZoneId.of("Asia/Shanghai")));

        // 获取一个设定日期
        System.out.println("LocalDate.of(2023,11, 12) = " + LocalDate.of(2023, 11, 12));
        // 根据参数设置日期，参数分别为年，月，日
        System.out.println("LocalDate.of(2023, Month.of(9), 30) = " + LocalDate.of(2023, Month.of(9), 30)); // 此处设置会有问题，如果你看到请测试

        // 年，一年中的第几天
        System.out.println("LocalDate.ofYearDay(2023, 316) = " + LocalDate.ofYearDay(2023, 316));
        System.out.println("LocalDate.parse(\"2023-11-12\") = " + LocalDate.parse("2023-11-12"));
}

打印结果如下：

3.2 LocalDate继承、重写功能

API方法	说明	是否常用
getDayOfMonth()	获取当前日期是所在月的第几天	是
getDayOfWeek().getValue()	获取当前日期是星期几（星期的英文全称）
getDayOfYear()	获取当前日期是所在年的第几天
getMonth()	获取当前日期所在月份（月份的英文全称）
getMonthValue()	获取当前日期所在月份的数值
lengthOfMonth()	获取当前日期所在月份有多少天，返回int	是
lengthOfYear()	获取当前日期所在年有多少天,返回int	是
isLeapYear()	获取当前日期所在年是否是闰年,返回boolean	是
with(TemporalAdjusters.firstDayOfMonth())	获取当前日期的第1天	是
with(TemporalAdjusters.lastDayOfMonth())	获取当前日期月份的最后一天	是
withDayOfMonth(int dayOfMonth)	将参数中的"日"替换localDate中的"日"
withDayOfYear(int dayOfYear)	将参数中的天数替换localDate中的天数
withMonth(int month)	将参数中的"月"替换localDate中的"月"
withYear(int year)	将参数中的"年"替换localDate中的"年"
minusDays(long days)	将当前日期减几天，一般用于工具类计算中	是
minusWeeks(long weeks)	将当前日期减几周，一般用于工具类计算中	是
minusMonths(long months)	将当前日期减几月
minusYears(long years)	将当前日期减几年
plusDays(long days)	将当前日期加几天，一般用于工具类计算中	是
plusWeeks(long weeks)	将当前日期加几周，一般用于工具类计算中	是
plusMonths(long months)	将当前日期加几月
plusYears(long years)	将当前日期加一年

代码如下：

    public static void main(String[] args) {
        System.out.println("-- LocalDate继承重写API功能");
        // getDayOfXXX函数，获取当前日期的星期（英文）、当前日期所在月份中的第几天、当前日期所在年份中的第几天
        System.out.println("LocalDate.now().getDayOfWeek() = " + LocalDate.now().getDayOfWeek());
        System.out.println("LocalDate.now().getDayOfMonth() = " + LocalDate.now().getDayOfMonth());
        System.out.println("LocalDate.now().getDayOfYear() = " + LocalDate.now().getDayOfYear());

        // lengthXXX函数，获取长度，主要是月有多少天、年有多少天
        System.out.println("LocalDate.now().lengthOfMonth() = " + LocalDate.now().lengthOfMonth());
        System.out.println("LocalDate.now().lengthOfYear() = " + LocalDate.now().lengthOfYear());

        // withXXX函数
        // 返回当前月、周、年的星期几。例如返回当前月的第一天、返回本周的星期二、星期三的日期
        System.out.println("LocalDate.now().with(ChronoField.DAY_OF_MONTH, 1)) = " + LocalDate.now().with(ChronoField.DAY_OF_MONTH, 1));
        System.out.println("LocalDate.now().with(ChronoField.DAY_OF_WEEK, 2) = " + LocalDate.now().with(ChronoField.DAY_OF_WEEK, 2));
        System.out.println("LocalDate.now().with(ChronoField.DAY_OF_WEEK, 3) = " + LocalDate.now().with(ChronoField.DAY_OF_WEEK, 3));
        // 主要是月份的设置，例如设置10月份，那么就返回当前日期的副本且只修改月份
        System.out.println("LocalDate.now().withMonth(10) = " + LocalDate.now().withMonth(10));

        // isXXX函数
        // 当前日期是否在指定日期之前/之后
        System.out.println("LocalDate.now().isBefore(LocalDate.now().minusDays(1)) = " + LocalDate.now().isBefore(LocalDate.now().minusDays(1)));
        System.out.println("LocalDate.now().isAfter(LocalDate.now().minusDays(1)) = " + LocalDate.now().isAfter(LocalDate.now().minusDays(1)));
        // 是否是闰年
        System.out.println("LocalDate.now().isLeapYear() = " + LocalDate.now().isLeapYear());

        // 日期加减，主要有两种类型：第一种是直接进行加减、使用TemporalAmount参数设定；第二种就是直接设定具体的参数
        // 方式一 在当前日期增加3个周期，周期单位为天
        System.out.println("LocalDate.now().plus(Period.ofDays(3)) = " + LocalDate.now().plus(Period.ofDays(3)));
        // 方式二 在当前日期增加4天，在当前日期减少2周
        System.out.println("LocalDate.now().plusDays(3) = " + LocalDate.now().plusDays(4));
        System.out.println("LocalDate.now().minusWeeks(2) = " + LocalDate.now().minusWeeks(2));
    }

打印结果如下：