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这三个类。
测试代码如下:
代码语言:javascript复制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) | 将当前日期加一年 |
代码如下:
代码语言:javascript复制 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));
}
打印结果如下:
4 总结
在JDK8之前我们都是使用Date或者Calendar来做计算或者转换,自从有了JDK8,我们的CVX速度很明显增强了。JDK8引入了许多新的特性和改进,使得代码编写更加简洁、可读性更高,并且提供了更好的性能和并发处理能力。
我正在参与2023腾讯技术创作特训营第三期有奖征文,组队打卡瓜分大奖!