Java中日期调整器（Date Adjuster）的详细说明、代码示例及使用场景，重点介绍Java 8+的java.time包中如何灵活调整日期-CSDN博客

本文链接：https://blog.csdn.net/zp357252539/article/details/146451060

以下是Java中**日期调整器（Date Adjuster）**的详细说明、代码示例及使用场景，重点介绍Java 8+的java.time包中如何灵活调整日期：

1. 什么是日期调整器？

日期调整器（TemporalAdjuster）是Java 8+中用于修改日期的逻辑封装，可实现复杂日期计算（如“下个月的最后一天”或“下一个工作日”）。它通过TemporalAdjusters工具类和自定义逻辑实现。

2. 常用内置调整器（`TemporalAdjusters`）

java.time.temporal.TemporalAdjusters提供了多个预定义的调整器：

(1) 示例代码

import java.time.LocalDate;
import java.time.temporal.TemporalAdjusters;

public class DateAdjusterExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今天: " + today); // 2023-10-21
        
        // 调整为本月的最后一天
        LocalDate lastDayOfMonth = today.with(TemporalAdjusters.lastDayOfMonth());
        System.out.println("本月最后一天: " + lastDayOfMonth); // 2023-10-31

        // 调整为下个月的同一天（若当月没有该日期则顺延）
        LocalDate nextMonthSameDay = today.with(TemporalAdjusters.nextOrSame(LocalDate::getDayOfMonth));
        System.out.println("下个月同一天: " + nextMonthSameDay); // 2023-11-21

        // 调整为下一个星期一
        LocalDate nextMonday = today.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
        System.out.println("下一个周一: " + nextMonday); // 2023-10-23
    }
}

(2) 内置调整器列表

调整器名称	功能描述	示例代码
`firstDayOfMonth()`	本月第一天	`date.with(TemporalAdjusters.firstDayOfMonth())`
`lastDayOfMonth()`	本月最后一天	`date.with(TemporalAdjusters.lastDayOfMonth())`
`next(DayOfWeek day)`	下一个指定星期（如周一）	`date.with(TemporalAdjusters.next(DayOfWeek.MONDAY))`
`previous(DayOfWeek day)`	上一个指定星期（如周五）	`date.with(TemporalAdjusters.previous(DayOfWeek.FRIDAY))`
`firstInMonth(DayOfWeek day)`	本月第一个指定星期（如第一个周一）	`date.with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY))`
`lastInMonth(DayOfWeek day)`	本月最后一个指定星期（如最后一个周日）	`date.with(TemporalAdjusters.lastInMonth(DayOfWeek.SUNDAY))`

3. 自定义日期调整器

若内置调整器无法满足需求，可通过实现TemporalAdjuster接口自定义逻辑：

示例：计算“下个季度的最后一天”

import java.time.LocalDate;
import java.time.temporal.Temporal;
import java.time.temporal.TemporalAdjuster;
import java.time.temporal.TemporalAdjusters;

public class CustomAdjusterExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate nextQuarterEnd = today.with(nextQuarterEnd());
        System.out.println("下个季度最后一天: " + nextQuarterEnd); // 2023-12-31（假设当前为2023-10）
    }

    // 自定义调整器：下个季度的最后一天
    public static TemporalAdjuster nextQuarterEnd() {
        return temporal -> {
            int monthValue = temporal.get(ChronoField.MONTH_OF_YEAR);
            int quarter = (monthValue - 1) / 3 + 1;
            int targetMonth = quarter * 3 + 1; // 下个季度的首月
            return temporal.plusMonths(3 * quarter)
                          .with(TemporalAdjusters.lastDayOfMonth());
        };
    }
}

4. 日期加减操作（`plus`/`minus`）

通过plus()和minus()方法可直接对日期进行增减：

示例：加减天/月/年

LocalDate today = LocalDate.now();
LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS); // 明天
LocalDate lastWeek = today.minus(7, ChronoUnit.DAYS); // 7天前
LocalDate nextYear = today.plusYears(1); // 下年同日
LocalDate previousMonth = today.minusMonths(1); // 上月同日

5. 与旧版`Calendar`对比

(1) 旧版`Calendar`的调整方式

import java.util.Calendar;
import java.util.Date;

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_MONTH, 1); // 明天
calendar.set(Calendar.DAY_OF_MONTH, 1); // 本月第一天

(2) 对比表格

特性	`java.util.Calendar`	`java.time`（Java 8+）
线程安全	否（可变对象）	是（不可变对象）
API友好性	复杂（如月份从0开始）	直观（如`plusDays()`）
调整器支持	无内置调整器，需手动逻辑	内置`TemporalAdjusters`和自定义能力
可读性	代码冗长且易错	代码简洁且意图明确

6. 典型应用场景

(1) 计算账单截止日

LocalDate paymentDueDate = 
    LocalDate.now().with(TemporalAdjusters.lastDayOfMonth()).minusDays(1);
// 本月最后一天的前一天

(2) 计算产品到期日

LocalDate purchaseDate = LocalDate.of(2023, 10, 21);
LocalDate expirationDate = purchaseDate.plusYears(1).minusDays(1);

(3) 跨季度报表日期

LocalDate quarterEnd = LocalDate.now().with(nextQuarterEnd()); // 自定义调整器

7. 总结

核心优势：
- java.time的调整器（TemporalAdjuster）提供清晰、线程安全的日期操作。
- 内置调整器覆盖常见场景（如月末、下个周一），自定义调整器灵活扩展。
推荐实践：
- 新项目直接使用LocalDate/LocalDateTime和TemporalAdjusters。
- 避免Calendar的复杂API，改用java.time的不可变对象设计。