深入了解Java8新特性-日期时间API之TemporalAdjusters与TemporalAdjuster

2023-12-01 09:28
文章标签 java 特性 深入 时间 api 了解 日期 temporaladjusters temporaladjuster

本文主要是介绍深入了解Java8新特性-日期时间API之TemporalAdjusters与TemporalAdjuster，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

阅读建议

嗨，伙计！刷到这篇文章咱们就是有缘人，在阅读这篇文章前我有一些建议：

  1. 本篇文章大概10000多字，预计阅读时间长需要10分钟。
  2. 本篇文章的实战性、理论性较强，是一篇质量分数较高的技术干货文章，建议收藏起来，方便时常学习与回顾，温故而知新。
  3. 创作不易，免费的点赞、关注，请走上一走，算是对博主一些鼓励，让我更有动力输出更多的干货内容。

注意

本文编写的单元测试是基于java11，具体的版本号是：11.0.19

TemporalAdjusters与TemporalAdjuster

TemporalAdjuster

TemporalAdjuster是Java 8中引入的新的日期时间API的一部分，是一个函数式接口。它能够执行复杂的日期操作，例如，可以获得下一个星期日、当月的最后一天或下一年的第一天。TemporalAdjuster只有一个带Temporal对象参数的抽象方法adjustInto()，可以通过向其传递Temporal对象在其任何实现中调用它。在TemporalAdjusters类中有许多预定义的实现，例如LocalDate、LocalDateTime等。

@FunctionalInterface
public interface TemporalAdjuster {Temporal adjustInto(Temporal temporal);
}

TemporalAdjusters

TemporalAdjusters也是Java 8中处理日期时间的工具类，但它的功能和TemporalAdjuster有所不同。TemporalAdjusters是一个静态工具类，提供了很多静态方法来创建TemporalAdjuster对象，这些方法可以用于对日期时间进行一些常用的调整操作，例如获取本月的第一天、下个月的第一天、本年的第一天或最后一天等。这些方法返回的TemporalAdjuster对象可以用于对日期时间进行相应的调整操作。

功能作用

TemporalAdjusters与TemporalAdjuster的作用在于提供了一种统一的、类型安全的方式来处理日期时间的操作。在过去的版本中，Java的日期时间API主要依赖于Calendar类，但这个类在处理复杂的日期时间操作时显得不够灵活和类型安全。TemporalAdjusters的出现弥补了这一缺陷，使得日期时间操作更加简洁、易用和类型安全。

TemporalAdjusters的意义在于它为Java日期时间API注入了更多的活力，使其更加适应现代应用程序的需求。通过TemporalAdjusters，开发人员可以更方便地处理日期时间的各种操作，例如添加或减去一定的时间量、获取特定时间单位的值、将日期时间转换为不同的格式等等。此外，TemporalAdjusters还支持链式调用，使得对日期时间的操作更加流畅和直观。

使用场景分析

TemporalAdjusters的使用场景非常广泛，可以应用于各种需要调整日期时间的场景。以下是一些常见的使用场景：

  • 计算日期时间差值：TemporalAdjusters提供了一组方法，可以轻松地计算两个日期时间之间的差值，例如计算两个日期之间的天数、小时数或分钟数等。
  • 获取特定时间单位的值：使用TemporalAdjusters可以方便地获取日期时间的特定时间单位的值，例如获取当前日期的年份、月份、日期等。
  • 调整日期时间：TemporalAdjusters提供了一组方法，可以对日期时间进行调整，例如在日期上添加或减去一定的时间量、将日期时间转换为不同的格式等。
  • 解析日期时间字符串：TemporalAdjusters可以用于解析日期时间字符串，并将其转换为Temporal对象。这使得开发人员可以更方便地处理日期时间的字符串表示形式。
  • 时区转换：TemporalAdjusters提供了一些方法，可以将日期时间从一个时区转换为另一个时区。这对于国际化应用程序来说非常有用，可以方便地处理不同时区之间的日期时间转换。

核心方法

TemporalAdjusters#ofDateAdjuster(...)

TemporalAdjusters.ofDateAdjuster(...) 它接受一个函数作为参数，该函数接受一个日期时间对象并返回一个新的日期时间对象，表示对该日期时间对象进行某种调整后的结果。这个方法返回一个TemporalAdjuster对象，可以用于对日期时间对象进行相应的调整操作。通常情况下，这个方法用于创建自定义的TemporalAdjuster对象，以执行一些复杂的日期时间调整操作。

@Test
public void test() {UnaryOperator<LocalDate> unaryOperator = item -> item.minusDays(1);//日期调节逻辑:减去1天TemporalAdjuster temporalAdjuster = TemporalAdjusters.ofDateAdjuster(unaryOperator);//构造日期调节器类LocalDate localDate1 = LocalDate.of(2023, 11, 22);//日期:2023-11-22LocalDate localDate2 = localDate1.with(temporalAdjuster);//执行调节逻辑,并返回调节后结果System.out.println(localDate2);//输出结果:2023-11-21
}

TemporalAdjusters#firstDayOfMonth()

TemporalAdjusters.firstDayOfMonth()是一个静态方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本月的第一天。

这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test1() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstDayOfMonth();LocalDateTime localDateTime = LocalDateTime.of(2023, 11, 12, 13, 1, 12);LocalDateTime localDateTime1 = localDateTime.with(temporalAdjuster);System.out.println(localDateTime1);//输出结果：2023-11-01T13:01:12
}

TemporalAdjusters#lastDayOfMonth()

TemporalAdjusters.lastDayOfMonth()是一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本月的最后一天。这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test2() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.lastDayOfMonth();LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-02-28
}

TemporalAdjusters#firstDayOfNextMonth()

TemporalAdjusters.firstDayOfNextMonth() 是一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为下一个月的第一天。这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test3() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstDayOfNextMonth();LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-03-01
}

TemporalAdjusters#firstDayOfYear()

TemporalAdjusters.firstDayOfYear() 是一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本年的第一天。这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test4() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstDayOfYear();LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-01-01
}

TemporalAdjusters#lastDayOfYear()

TemporalAdjusters.lastDayOfYear() 是 一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本年的最后一天。这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test5() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.lastDayOfYear();LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-12-31
}

TemporalAdjusters#firstDayOfNextYear()

TemporalAdjusters.firstDayOfNextYear() 是一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为下一年度的第一天。这个方法返回的 TemporalAdjuster 对象可以与任何实现了 java.time.temporal.Temporal 接口的对象一起使用，例如 LocalDate、LocalDateTime、ZonedDateTime 等。使用 with 方法将 TemporalAdjuster 应用于这些对象，可以对日期进行调整。

@Test
public void test6() {TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstDayOfNextYear();LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2024-01-01
}

TemporalAdjusters#firstInMonth(...)

TemporalAdjusters.firstInMonth() 是 Java 8 中 java.time.temporal.TemporalAdjusters 类的一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本月的第一个星期几。这个方法接受一个 DayOfWeek 类型的参数，用于指定要调整到的星期几。例如，如果想要将日期调整为当前日期月份的第一个星期二，可以这样使用：

@Test
public void test7() {DayOfWeek dayOfWeek = DayOfWeek.of(2);TemporalAdjuster temporalAdjuster = TemporalAdjusters.firstInMonth(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-02-07
}

TemporalAdjusters#lastInMonth(...)

TemporalAdjusters.lastInMonth() 是一个静态工厂方法，用于创建一个 TemporalAdjuster 对象，该对象可以用于将给定的日期调整为本月的最后一个星期几。这个方法接受一个 DayOfWeek 类型的参数，用于指定要调整到的星期几。例如，如果想要将日期调整为本月的最后一个星期二，可以这样使用：

@Test
public void test8() {DayOfWeek dayOfWeek = DayOfWeek.of(2);TemporalAdjuster temporalAdjuster = TemporalAdjusters.lastInMonth(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 2, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-02-28
}

TemporalAdjusters#dayOfWeekInMonth(...)

TemporalAdjusters.dayOfWeekInMonth() 是一个静态工厂方法，用于调整日期的静态方法。这个方法可以用来将给定的日期调整为指定月份中的指定星期几的日期。

这个方法接受两个参数：

  • ordinal - 一个整数，表示月份中的第几天。范围从 1（月份的第一天）到 28、29、30 或 31（根据月份和年份而定）。
  • dayOfWeek - 一个 DayOfWeek 枚举值，表示要调整到的星期几。例如，DayOfWeek.MONDAY 表示星期一。

使用这个方法，你可以将日期调整到指定月份的特定星期几。例如，如果你想将日期调整到 11 月的第一个星期三，你可以这样使用：

@Test
public void test9() {DayOfWeek dayOfWeek = DayOfWeek.of(3);TemporalAdjuster temporalAdjuster = TemporalAdjusters.dayOfWeekInMonth(1, dayOfWeek);LocalDate localDate = LocalDate.of(2023, 11, 30);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-11-01
}

TemporalAdjusters#next(...)

TemporalAdjusters.next(DayOfWeek dayOfWeek) 是一个用于调整日期的静态方法，这个方法可以用来将给定的日期调整到下一个指定星期几。这个方法接受一个 DayOfWeek 参数，表示要调整到的星期几。例如，DayOfWeek.MONDAY 表示星期一。使用这个方法，你可以将日期调整到下一个特定星期几。例如，如果你想将日期调整到下一个星期日，你可以这样使用：

@Test
public void test10() {DayOfWeek dayOfWeek = DayOfWeek.SUNDAY;TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 12, 3);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-12-10
}

TemporalAdjusters#nextOrSame(...)

TemporalAdjusters.nextOrSame(DayOfWeek dayOfWeek) 是一个用于调整日期的静态方法，这个方法可以用来将给定的日期调整到下一个或相同的星期几。这个方法接受一个 DayOfWeek 参数，表示要调整到的星期几。例如，DayOfWeek.MONDAY 表示星期一。

TemporalAdjusters#nextOrSame(...)与TemporalAdjusters#next(...)区别在于：TemporalAdjusters.nextOrSame(DayOfWeek dayOfWeek) 方法将给定的日期调整到下一个或相同的星期几。这意味着，如果给定的日期已经是星期几，那么调整后的日期将与原始日期相同。否则，调整后的日期将是下一个星期几。TemporalAdjusters.next(DayOfWeek dayOfWeek) 方法将给定的日期调整到下一个星期几，不考虑原始日期是否已经是指定星期几。

假如当前日期是2023年11月30日星期四，返回下一周星期四的日期，使用TemporalAdjusters#nextOrSame(...)，返回结果是2023-12-07；而使用TemporalAdjusters#nextOrSame(...)返回的则是其本身2023-11-30，除了这种特殊情况外，其余则是等同的。

@Test
public void test11() {DayOfWeek dayOfWeek = DayOfWeek.of(4);TemporalAdjuster temporalAdjuster = TemporalAdjusters.next(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 11, 30);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-12-07TemporalAdjuster temporalAdjuster1 = TemporalAdjusters.nextOrSame(dayOfWeek);LocalDate localDate2 = LocalDate.of(2023, 11, 30);LocalDate localDate3 = localDate2.with(temporalAdjuster1);System.out.println(localDate3);//输出结果：2023-11-30
}

TemporalAdjusters#previous(...)

TemporalAdjusters.previous(DayOfWeek dayOfWeek) 是一个用于调整日期的静态方法，这个方法可以用来将给定的日期调整到上一个星期几。这个方法接受一个 DayOfWeek 参数，表示要调整到的星期几。例如，DayOfWeek.MONDAY 表示星期一。

使用这个方法，你可以将日期调整到上一个或同一天的特定星期几。例如，如果你想将日期调整到上一个周的星期三，你可以这样使用：

@Test
public void test12() {DayOfWeek dayOfWeek = DayOfWeek.of(3);TemporalAdjuster temporalAdjuster = TemporalAdjusters.previous(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 11, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-10-25
}

TemporalAdjusters#previousOrSame(...)

TemporalAdjusters#previousOrSame(DayOfWeek dayOfWeek) 是一个用于调整日期的静态方法，这个方法可以用来将给定的日期调整到上一个或相同的星期几。这个方法接受一个 DayOfWeek 参数，表示要调整到的星期几。例如，DayOfWeek.MONDAY 表示星期一。

TemporalAdjusters#previousOrSame(...)和TemporalAdjusters#previous(...)的区别，与上面的TemporalAdjusters#nextOrSame(...)与TemporalAdjusters#next(...)区别是类似的，不过是上面是下一周，这里是上一周。

使用这个方法，你可以将日期调整到上一个或同一天的特定星期几。例如，如果你想将日期调整到上一个或同一天的星期三，你可以这样使用：

@Test
public void test13() {DayOfWeek dayOfWeek = DayOfWeek.of(3);TemporalAdjuster temporalAdjuster = TemporalAdjusters.previous(dayOfWeek);LocalDate localDate = LocalDate.of(2023, 11, 1);LocalDate localDate1 = localDate.with(temporalAdjuster);System.out.println(localDate1);//输出结果：2023-10-25TemporalAdjuster temporalAdjuster1 = TemporalAdjusters.nextOrSame(dayOfWeek);LocalDate localDate2 = LocalDate.of(2023, 11, 1);LocalDate localDate3 = localDate2.with(temporalAdjuster1);System.out.println(localDate3);//输出结果：2023-11-01
}

这篇关于深入了解Java8新特性-日期时间API之TemporalAdjusters与TemporalAdjuster的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/440620。

相关文章

Python标准库datetime模块日期和时间数据类型解读

Python标准库datetime模块日期和时间数据类型解读

《Python标准库datetime模块日期和时间数据类型解读》文章介绍Python中datetime模块的date、time、datetime类,用于处理日期、时间及日期时间结合体,通过属性获取时间... 目录Datetime常用类日期date类型使用时间 time 类型使用日期和时间的结合体–日期时间(
阅读更多...
分布式锁在Spring Boot应用中的实现过程

分布式锁在Spring Boot应用中的实现过程

《分布式锁在SpringBoot应用中的实现过程》文章介绍在SpringBoot中通过自定义Lock注解、LockAspect切面和RedisLockUtils工具类实现分布式锁,确保多实例并发操作... 目录Lock注解LockASPect切面RedisLockUtils工具类总结在现代微服务架构中，分布
阅读更多...
Java使用Thumbnailator库实现图片处理与压缩功能

Java使用Thumbnailator库实现图片处理与压缩功能

《Java使用Thumbnailator库实现图片处理与压缩功能》Thumbnailator是高性能Java图像处理库,支持缩放、旋转、水印添加、裁剪及格式转换,提供易用API和性能优化,适合Web应... 目录1. 图片处理库Thumbnailator介绍2. 基本和指定大小图片缩放功能2.1 图片缩放的
阅读更多...
Spring Boot集成/输出/日志级别控制/持久化开发实践

Spring Boot集成/输出/日志级别控制/持久化开发实践

《SpringBoot集成/输出/日志级别控制/持久化开发实践》SpringBoot默认集成Logback,支持灵活日志级别配置（INFO/DEBUG等）,输出包含时间戳、级别、类名等信息,并可通过... 目录一、日志概述1.1、Spring Boot日志简介1.2、日志框架与默认配置1.3、日志的核心作用
阅读更多...
破茧 JDBC:MyBatis 在 Spring Boot 中的轻量实践指南

破茧 JDBC:MyBatis 在 Spring Boot 中的轻量实践指南

《破茧JDBC:MyBatis在SpringBoot中的轻量实践指南》MyBatis是持久层框架,简化JDBC开发,通过接口+XML/注解实现数据访问,动态代理生成实现类,支持增删改查及参数... 目录一、什么是 MyBATis二、 MyBatis 入门2.1、创建项目2.2、配置数据库连接字符串2.3、入
阅读更多...
Springboot项目启动失败提示找不到dao类的解决

Springboot项目启动失败提示找不到dao类的解决

《Springboot项目启动失败提示找不到dao类的解决》SpringBoot启动失败,因ProductServiceImpl未正确注入ProductDao,原因：Dao未注册为Bean,解决：在启... 目录错误描述原因解决方法总结***************************APPLICA编
阅读更多...
深度解析Spring Security 中的 SecurityFilterChain核心功能

深度解析Spring Security 中的 SecurityFilterChain核心功能

《深度解析SpringSecurity中的SecurityFilterChain核心功能》SecurityFilterChain通过组件化配置、类型安全路径匹配、多链协同三大特性,重构了Spri... 目录Spring Security 中的SecurityFilterChain深度解析一、Security
阅读更多...
SpringBoot多环境配置数据读取方式

SpringBoot多环境配置数据读取方式

《SpringBoot多环境配置数据读取方式》SpringBoot通过环境隔离机制,支持properties/yaml/yml多格式配置,结合@Value、Environment和@Configura... 目录一、多环境配置的核心思路二、3种配置文件格式详解2.1 properties格式（传统格式）1.
阅读更多...
Apache Ignite 与 Spring Boot 集成详细指南

Apache Ignite 与 Spring Boot 集成详细指南

《ApacheIgnite与SpringBoot集成详细指南》ApacheIgnite官方指南详解如何通过SpringBootStarter扩展实现自动配置,支持厚/轻客户端模式,简化Ign... 目录 一、背景：为什么需要这个集成？ 二、两种集成方式（对应两种客户端模型） 三、方式一：自动配置 Thick
阅读更多...
Spring WebClient从入门到精通

Spring WebClient从入门到精通

《SpringWebClient从入门到精通》本文详解SpringWebClient非阻塞响应式特性及优势,涵盖核心API、实战应用与性能优化,对比RestTemplate,为微服务通信提供高效解决... 目录一、WebClient 概述1.1 为什么选择 WebClient？1.2 WebClient 与
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2