Java中根据年和周数获取周的起始与结束日期

本文详细介绍了如何在java中使用`java.time`包，根据给定的年份和周数，精确计算出该周的起始日期（周一）和结束日期（周日）。通过利用`localdate.parse`方法结合`datetimeformatter.iso_week_date`格式化器，开发者可以高效且准确地处理基于周的日期计算，并理解“周年”概念对日期边界的影响。

在现代应用开发中，根据特定的年份和周数来确定一个星期的起始和结束日期是一个常见的需求，尤其是在报表、日程管理或数据分析场景中。Java 8引入的java.time包（JSR-310）提供了强大且易用的日期时间API，可以优雅地解决此类问题。

核心方法：使用ISO_WEEK_DATE格式解析日期

java.time包中LocalDate类结合DateTimeFormatter.ISO_WEEK_DATE提供了一种简洁而强大的方式来处理基于周的日期计算。ISO_WEEK_DATE格式遵循ISO 8601标准，其模式为YYYY-Www-D，其中YYYY代表年份，Www代表周数（前面带'W'），D代表星期几（1为周一，7为周日）。

要从给定的年份和周数获取周的起始日期（周一）和结束日期（周日），我们可以构造一个符合ISO_WEEK_DATE格式的字符串，然后使用LocalDate.parse()方法进行解析。

步骤详解

1. 构造格式化字符串： 根据ISO 8601标准，我们需要构建一个形如YYYY-Www-1的字符串来表示该周的周一。这里的1明确指定了我们想要获取的是该周的第一天，即星期一。 String.format("%04d-W%02d-1", year, week)可以帮助我们生成这个字符串，其中%04d确保年份是四位数，%02d确保周数是两位数（不足两位前面补零）。

2. 解析周一日期： 使用LocalDate.parse(formattedString, DateTimeFormatter.ISO_WEEK_DATE)方法将构造的字符串解析为LocalDate对象，这将得到该周的星期一。

3. 计算周日日期： 一旦获取了周一的LocalDate对象，只需在其基础上增加6天，即可得到该周的星期日。monday.plusDays(6)方法可以实现这一点。

示例代码

以下是一个完整的Java代码示例，演示如何根据年份和周数获取周的起始和结束日期：

畅图

AI可视化工具

147

查看详情

立即学习“Java免费学习笔记（深入）”；

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class WeekDateCalculator {

    /**
     * 根据年份和周数获取该周的起始日期（周一）和结束日期（周日）。
     *
     * @param year 年份，例如 2022
     * @param weekNum 周数，例如 49
     * @return 包含起始日期和结束日期的字符串数组，索引0为周一，索引1为周日。
     */
    public static String[] getStartAndEndDateOfWeek(int year, int weekNum) {
        // 1. 构造符合ISO_WEEK_DATE格式的字符串，指定为该周的周一
        String weekMondayString = String.format("%04d-W%02d-1", year, weekNum);

        // 2. 使用DateTimeFormatter.ISO_WEEK_DATE解析周一日期
        LocalDate monday = LocalDate.parse(weekMondayString, DateTimeFormatter.ISO_WEEK_DATE);

        // 3. 计算周日日期（周一加6天）
        LocalDate sunday = monday.plusDays(6);

        // 返回结果
        return new String[]{monday.toString(), sunday.toString()};
    }

    public static void main(String[] args) {
        int year = 2022;
        int week = 49;

        String[] dates = getStartAndEndDateOfWeek(year, week);
        System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n",
                          week, year, dates[0], dates[1]);

        // 示例：2022年第49周
        // 预期输出：2022-W49-1 -> 2022-12-05 (周一)
        // 2022-12-05 + 6天 -> 2022-12-11 (周日)

        // 另一个示例：可能跨年的周
        // 2023年第1周，其周一可能在2022年
        year = 2023;
        week = 1;
        dates = getStartAndEndDateOfWeek(year, week);
        System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n",
                          week, year, dates[0], dates[1]);
        // 预期输出：2023-W01-1 -> 2023-01-02 (周一)
        // 2023-01-02 + 6天 -> 2023-01-08 (周日)
        // 注意：有些年份的第1周可能从前一年的12月开始，ISO_WEEK_DATE会正确处理
        // 例如，2020年的第1周从2019-12-30开始
        year = 2020;
        week = 1;
        dates = getStartAndEndDateOfWeek(year, week);
        System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n",
                          week, year, dates[0], dates[1]);
        // 预期输出：2020-W01-1 -> 2019-12-30 (周一)
        // 2019-12-30 + 6天 -> 2020-01-05 (周日)
    }
}

运行上述代码，对于输入year = 2022, week = 49，将输出： 年份 49 的第 2022 周从 2022-12-05 开始，到 2022-12-11 结束。

对于输入year = 2023, week = 1，将输出： 年份 1 的第 2023 周从 2023-01-02 开始，到 2023-01-08 结束。

对于输入year = 2020, week = 1，将输出： 年份 1 的第 2020 周从 2019-12-30 开始，到 2020-01-05 结束。

注意事项

1. “周年”概念（Week-Year）：DateTimeFormatter.ISO_WEEK_DATE处理的是“周年”（Week-Year）系统，而非简单的日历年。这意味着一周的起始日期可能落在前一个日历年，或者结束日期可能落在下一个日历年。例如，某些年份的第一周（Week 1）可能从前一年的12月30日开始，而某些年份的最后一周（Week 52或53）可能延续到下一年的1月。这种行为是符合ISO 8601标准的，并且对于需要严格按照周进行计算的场景至关重要。

2. 月份的无关性： 在根据年份和周数确定日期时，月份信息是无关紧要的。因为周数本身就定义了在给定年份中的位置，月份只是日历年的一种划分方式，与周年的计算逻辑不直接相关。

3. JSR310-extra库： 虽然java.time本身没有直接提供一个YearWeek类，但threeten-extra库（JSR310-extra）中包含了org.threeten.extra.YearWeek，它提供了更面向对象的API来处理年份和周数。如果项目允许引入额外依赖，YearWeek可以提供更高级别的抽象和便利性。然而，对于大多数基础需求，java.time内置的解析方法已足够强大且无需额外依赖。

总结

通过利用java.time.LocalDate和DateTimeFormatter.ISO_WEEK_DATE，我们可以高效、准确地根据年份和周数计算出任意一周的起始（周一）和结束（周日）日期。理解ISO 8601的“周年”概念是正确使用此方法的关键。这种方法不仅代码简洁，而且避免了手动处理复杂的日期逻辑和跨年问题，是Java日期时间处理的推荐实践。

以上就是Java中根据年和周数获取周的起始与结束日期的详细内容，更多请关注php中文网其它相关文章！