本教程详细介绍了如何使用java 8及更高版本的`java.time` api，根据给定的年份和周数计算出该周的起始日期（周一）和结束日期（周日）。文章通过`datetimeformatter.iso_week_date`解析iso周日期格式字符串，结合`localdate`对象进行日期计算，并强调了iso周-年系统的特性，即周的起止日期可能跨越日历年界限。
使用 java.time 获取指定周的起始和结束日期
在现代Java应用开发中，处理日期和时间是常见的任务。当需要根据年份和周数来确定一个特定周的起始日期（通常是周一）和结束日期（周日）时，java.time 包提供了强大且简洁的解决方案。本教程将详细介绍如何利用 LocalDate 和 DateTimeFormatter.ISO_WEEK_DATE 来实现这一功能。
理解 ISO 周日期格式
ISO 8601 标准定义了一种表示周日期的方式，其格式为 YYYY-Www-D。
- YYYY 代表 ISO 周-年（week-year）。
- Www 代表该周在 ISO 周-年中的序号，其中 ww 是两位数的周数（例如 W01, W49）。
- D 代表一周中的星期几，1 表示周一，7 表示周日。
例如，2022-W49-1 表示 2022 年第 49 周的周一。
核心实现方法
java.time 包中的 LocalDate.parse() 方法结合 DateTimeFormatter.ISO_WEEK_DATE 可以直接解析这种格式的字符串，从而得到该周的周一日期。一旦获取了周一的日期，计算周日就变得非常简单，只需在此基础上增加 6 天即可。
立即学习“Java免费学习笔记（深入）”；
以下是实现这一功能的具体步骤和示例代码：
- 构建 ISO 周日期字符串：根据给定的年份和周数，以及我们希望获取周一的日期（即 D 为 1），格式化生成一个符合 YYYY-Www-D 规范的字符串。
- 解析字符串为 LocalDate：使用 LocalDate.parse() 方法和 DateTimeFormatter.ISO_WEEK_DATE 将步骤 1 生成的字符串解析为 LocalDate 对象，这将得到该周的周一日期。
- 计算周日日期：在周一的 LocalDate 对象上调用 plusDays(6) 方法，即可得到该周的周日日期。
示例代码
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
public class WeekDateCalculator {
/**
* 根据年份和周数获取该周的起始日期（周一）和结束日期（周日）。
*
* @param year 给定的年份（ISO 周-年）。
* @param week 给定的周数。
* @return 包含起始日期和结束日期的 LocalDate 数组，索引 0 为周一，索引 1 为周日。
*/
public static LocalDate[] getWeekStartAndEndDate(int year, int week) {
// 1. 构建 ISO 周日期字符串。
// %04d 确保年份是四位数，%02d 确保周数是两位数（不足补零）。
String isoWeekDateString = String.format("%04d-W%02d-1", year, week);
// 2. 解析字符串为 LocalDate，获取该周的周一。
// DateTimeFormatter.ISO_WEEK_DATE 专门用于解析 ISO 8601 周日期格式。
LocalDate monday = LocalDate.parse(isoWeekDateString, DateTimeFormatter.ISO_WEEK_DATE);
// 3. 计算周日日期。
LocalDate sunday = monday.plusDays(6);
return new LocalDate[]{monday, sunday};
}
public static void main(String[] args) {
int year = 2022;
int week = 49;
LocalDate[] dates = getWeekStartAndEndDate(year, week);
LocalDate startDate = dates[0];
LocalDate endDate = dates[1];
System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n", week, year, startDate, endDate);
// 预期输出：年份 49 的第 2022 周从 2022-12-05 开始，到 2022-12-11 结束。
// 示例：跨年周的情况
int year2 = 2023;
int week2 = 1; // 2023年的第一周
LocalDate[] dates2 = getWeekStartAndEndDate(year2, week2);
System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n", week2, year2, dates2[0], dates2[1]);
// 预期输出：年份 1 的第 2023 周从 2023-01-02 开始，到 2023-01-08 结束。
int year3 = 2022;
int week3 = 52; // 2022年的最后一周
LocalDate[] dates3 = getWeekStartAndEndDate(year3, week3);
System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n", week3, year3, dates3[0], dates3[1]);
// 预期输出：年份 52 的第 2022 周从 2022-12-26 开始，到 2023-01-01 结束。
}
}注意事项
-
ISO 周-年系统 (Week-Year System)： DateTimeFormatter.ISO_WEEK_DATE 遵循的是 ISO 8601 标准定义的周-年系统，而非简单的日历年。这意味着：
- 第一周的起始日期可能在前一年：一个 ISO 周-年的第一周（W01）可能从前一年的 12 月底开始。例如，2023 年的第一周是从 2023-01-02 开始，但某些年份的第一周可能从前一年的 12 月 30 日或 31 日开始。
- 最后一周的结束日期可能在下一年：一个 ISO 周-年的最后一周（W52 或 W53）可能延续到下一年的 1 月初。例如，2022 年的第 52 周从 2022-12-26 开始，到 2023-01-01 结束。 理解这一点对于跨年日期的处理至关重要。
月份的无关性： 在根据年份和周数计算周的起止日期时，月份信息是无关紧要的。因为周数是基于整个年份（或 ISO 周-年）进行编号的，与具体的月份划分无关。
替代方案（了解）： 虽然 java.time 提供了强大的核心功能，但对于更复杂的周-年操作，例如直接从 Year 和 WeekFields 构建周对象，或者处理不同国家/地区的周定义（例如，有些地区以周日作为一周的开始），可以使用 threeten-extra 这样的外部库，它提供了 YearWeek 等更高级的抽象。然而，对于大多数常见场景，java.time 提供的解决方案已经足够简洁和高效。
总结
通过 java.time 包，特别是 LocalDate 和 DateTimeFormatter.ISO_WEEK_DATE，我们可以非常方便且准确地从给定的年份和周数计算出该周的起始日期和结束日期。这种方法简洁、符合标准，并且充分考虑了 ISO 周-年系统带来的跨年情况。在进行日期相关开发时，推荐优先使用 java.time API 来处理此类需求。
