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

news/2024/5/19 15:06:28 标签: Temporal, Adjusters, Java8新特性, 日期时间API, java, 后端

阅读建议

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

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

注意

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

TemporalAdjusters与TemporalAdjuster

TemporalAdjuster

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

java">@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对象，以执行一些复杂的日期时间调整操作。

java">@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-22
    LocalDate 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 应用于这些对象，可以对日期进行调整。

java">@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 应用于这些对象，可以对日期进行调整。

java">@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 应用于这些对象，可以对日期进行调整。

java">@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 应用于这些对象，可以对日期进行调整。

java">@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 应用于这些对象，可以对日期进行调整。

java">@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 应用于这些对象，可以对日期进行调整。

java">@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 类型的参数，用于指定要调整到的星期几。例如，如果想要将日期调整为当前日期月份的第一个星期二，可以这样使用：

java">@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 类型的参数，用于指定要调整到的星期几。例如，如果想要将日期调整为本月的最后一个星期二，可以这样使用：

java">@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 月的第一个星期三，你可以这样使用：

java">@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 表示星期一。使用这个方法，你可以将日期调整到下一个特定星期几。例如，如果你想将日期调整到下一个星期日，你可以这样使用：

java">@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，除了这种特殊情况外，其余则是等同的。

java">@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-07
    TemporalAdjuster 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 表示星期一。

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

java">@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(...)区别是类似的，不过是上面是下一周，这里是上一周。

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

java">@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-25
    TemporalAdjuster temporalAdjuster1 = TemporalAdjusters.nextOrSame(dayOfWeek);
    LocalDate localDate2 = LocalDate.of(2023, 11, 1);
    LocalDate localDate3 = localDate2.with(temporalAdjuster1);
    System.out.println(localDate3);//输出结果：2023-11-01
}


http://www.niftyadmin.cn/n/5228129.html

相关文章

「Bomkus 博士的试炼」排行榜规则更新

「Bomkus 博士的试炼」排行榜规则更新

亲爱的玩家们 为了回应我们从社区收到的宝贵反馈&#xff0c;我们希望与大家分享我们为防止在「Bomkus 博士的试炼」排行榜中作弊而采取的措施的最新进展&#xff0c;并就这一主题提供更多说明。 除了在活动开始前采取的反作弊措施外&#xff0c;我们还根据观察到的和报告的行为…
阅读更多...
（五）基于高尔夫优化算法GOA求解无人机三维路径规划研究（MATLAB代码）

（五）基于高尔夫优化算法GOA求解无人机三维路径规划研究（MATLAB代码）

一、无人机模型简介&#xff1a; 单个无人机三维路径规划问题及其建模_IT猿手的博客-CSDN博客 参考文献&#xff1a; [1]胡观凯,钟建华,李永正,黎万洪.基于IPSO-GA算法的无人机三维路径规划[J].现代电子技术,2023,46(07):115-120 二、高尔夫优化算法GOA简介 高尔夫优化算法…
阅读更多...
nvm下载node.js以及环境变量配置

nvm下载node.js以及环境变量配置

文章目录 一.卸载node.js二.安装nvm以及nvm环境配置2.1 安装nvm2.2 nvm环境配置 三.node.js安装以及环境配置3.1 node.js安装3.2 node.js环境配置3.3 node.js的环境配置参考如下文章。 一.卸载node.js 找到自己对应的node.js文件所在路径&#xff0c;通过控制面板卸载node.js&…
阅读更多...
class promise

class promise

class 语法糖 声明 class就是构造函数的语法糖&#xff0c;在使用继承的时候会更加方便&#xff0c;并且在思想上和java等统一起来 类声明和类表达式。这两种方式都使用class关键字加大括号&#xff1a; // 类声明 class Person {}// 类表达式 const TestPerson class {} …
阅读更多...
linux下的工具---gdb

linux下的工具---gdb

一、gdb简介 GDB,是The GNU Project Debugger 的缩写&#xff0c;是 Linux 下功能全面的调试工具。 GDB支持断点、单步执行、打印变量、观察变量、查看寄存器、查看堆栈等调试手段。 程序的发布方式有两种&#xff0c;debug模式和release模式 Linux gcc/g出来的二进制程序&am…
阅读更多...
SNAT / DNAT 自定义链

SNAT / DNAT 自定义链

目录 linux 系统本身是没有转发功能&#xff0c;只有路由发送数据 NAT NAT的实现分为两类 SNAT SNAT 应用环境 SNAT 原理 SNAT 转换前提条件 例图参考 开启 SNAT 命令 临时开启 永久开启 修改 iptables 网卡 DNAT DNAT 应用环境 DNAT 原理 DNAT 转换前提条件 …
阅读更多...
CG 函数

CG 函数

函数 与C#函数的语法一致 无返回值函数 void FunctionName(参数类型 参数…){} 有返回值 type FunctionName(参数类型 参数){return type} in关键字 in关键字可以修饰参数类型 修饰的参数作为输入参数 在函数内部使用 函数内部不能修改 void Test(in int a){ ba10;} Test(2…
阅读更多...
C++——AVL树

C++——AVL树

作者&#xff1a;几冬雪来 时间&#xff1a;2023年11月30日 内容&#xff1a;C板块AVL树讲解 目录 前言&#xff1a; AVL树与搜索二叉树之间的关系&#xff1a; AVL树概念&#xff1a; 插入结点&#xff1a; 平衡因子&#xff1a; 旋转&#xff1a; 双旋&#xff1a; …
阅读更多...
最新文章

Copyright @ 2022~2023