使用Java java.time API获取指定周的起始与结束日期

本文详细介绍了如何利用java 8及更高版本中的`java.time` api，根据给定的年份和周数（遵循iso 8601标准）精确计算出该周的起始日期（周一）和结束日期（周日）。通过`datetimeformatter.iso_week_date`解析特定格式的字符串，可以便捷地获取`localdate`对象，并深入探讨了周年（week-year）与日历年（calendar year）之间的重要区别，确保日期计算的准确性。

引言

在日常的软件开发中，经常会遇到需要根据年份和周数来确定该周具体起始日期和结束日期的场景。例如，一个报表系统可能需要展示某年第X周的数据，这就要求我们能够准确地计算出该周的周一和周日是哪一天。Java 8引入的java.time包提供了一套强大且易于使用的日期时间API，可以高效地解决这类问题。

使用 java.time API 获取周的起始与结束日期

java.time API中并没有直接提供一个方法来根据年份和周数直接获取LocalDate对象。然而，它支持ISO 8601标准中的“周日期”格式（Week Date），这为我们提供了一个优雅的解决方案。ISO 8601周日期格式为 YYYY-Www-D，其中：

• YYYY 代表年份（更准确地说是“周年”，即 Week-Year）。
• Www 代表周数，W 是前缀，ww 是两位数的周数（例如 W01 代表第一周）。
• D 代表周几，从1（周一）到7（周日）。

利用这一标准，我们可以构造一个符合此格式的字符串，然后使用 DateTimeFormatter.ISO_WEEK_DATE 进行解析，从而得到该周的任意一天（通常是周一），进而推算出周日。

示例代码

以下是使用Java代码实现从年份和周数获取周一和周日日期的示例：

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

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

public class WeekDateCalculator {

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

        // 1. 构造ISO 8601周日期格式的字符串
        // "%04d-W%02d-1" 表示：4位年份 - W + 2位周数 - 1 (表示周一)
        String weekDateString = String.format("%04d-W%02d-1", year, weekNum);
        System.out.println("构造的周日期字符串: " + weekDateString);

        // 2. 使用 DateTimeFormatter.ISO_WEEK_DATE 解析字符串，获取周一的日期
        LocalDate monday = LocalDate.parse(weekDateString, DateTimeFormatter.ISO_WEEK_DATE);

        // 3. 在周一的基础上增加6天，得到周日
        LocalDate sunday = monday.plusDays(6);

        System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n",
                          weekNum, year, monday, sunday);

        // 另一个例子：跨年周的情况
        year = 2023;
        weekNum = 1; // 2023年的第一周可能开始于2022年
        weekDateString = String.format("%04d-W%02d-1", year, weekNum);
        monday = LocalDate.parse(weekDateString, DateTimeFormatter.ISO_WEEK_DATE);
        sunday = monday.plusDays(6);
        System.out.printf("年份 %d 的第 %d 周从 %s 开始，到 %s 结束。\n",
                          weekNum, year, monday, sunday);
    }
}

代码解释：

畅图

AI可视化工具

147

查看详情

1. String.format("%04d-W%02d-1", year, weekNum): 这一步是核心。它根据输入的 year 和 weekNum 变量，生成一个符合ISO 8601周日期格式的字符串。
   • %04d 确保年份以四位数字表示，不足四位时前面补零（例如 2022）。
   • W 是字面量，表示周。
   • %02d 确保周数以两位数字表示，不足两位时前面补零（例如 49 或 01）。
   • -1 指定我们要获取的是该周的周一。
   • 例如，对于 year = 2022, weekNum = 49，生成的字符串是 2022-W49-1。
2. LocalDate.parse(weekDateString, DateTimeFormatter.ISO_WEEK_DATE): LocalDate 的 parse 方法结合 DateTimeFormatter.ISO_WEEK_DATE 可以将我们构造的字符串解析成一个 LocalDate 对象，该对象即为该周的周一。
3. monday.plusDays(6): LocalDate 对象是不可变的。plusDays(6) 方法会在 monday 的基础上增加6天，并返回一个新的 LocalDate 对象，代表该周的周日。

注意事项与重要概念

1. ISO 8601 周日期标准

上述方法严格遵循ISO 8601标准。根据该标准，一周的开始是周一，结束是周日。一年中的第一周（Week 01）是包含该年第一个星期四的那一周。这意味着：

• 如果1月1日是周一、周二、周三或周四，那么它所在的周就是该年的第一周。
• 如果1月1日是周五、周六或周日，那么它所在的周是前一年的最后一周，而该年的第一周将从1月第一个周一开始。

2. 周年（Week-Year）与日历年（Calendar Year）的区别

这是一个非常重要的概念，也是此方法处理跨年周的关键。

• 日历年（Calendar Year）: 指从1月1日到12月31日的传统年份。
• 周年（Week-Year）: 指与ISO 8601周数系统相关联的年份。一个周年可能不完全与日历年重合。
  • 例如，某年的第一周（Week 1）可能从前一年的12月30日或31日开始。在这种情况下，虽然日期属于前一个日历年，但它被视为当前周年的第一周。
  • 同样，某年的最后一周（Week 52或53）可能结束于下一个日历年的1月1日、2日或3日。

示例代码中第二个例子 year = 2023, weekNum = 1 很好地展示了这一点。2023年的第一周实际上从2023年1月2日（周一）开始，结束于2023年1月8日（周日）。如果输入是2022年第52周，其结束日期可能落在2023年。这种“跨年”现象是ISO周日期系统的正常行为，也是其精确性的体现。

3. 适用性

此方法适用于任何需要按照ISO 8601标准计算周起始和结束日期的场景。如果您的系统或业务逻辑遵循不同的周定义（例如，一周从周日开始，或者周数计算方式不同），则需要根据具体情况调整逻辑或使用其他日期时间库。

总结

利用java.time API和ISO 8601周日期标准，我们可以简洁而准确地从给定的年份和周数计算出该周的起始日期（周一）和结束日期（周日）。通过构造特定格式的字符串并使用 DateTimeFormatter.ISO_WEEK_DATE 进行解析，开发者可以轻松处理日期计算中的复杂性，特别是跨年周的情况。理解周年与日历年的区别是正确使用此方法的关键。

以上就是使用Java java.time API获取指定周的起始与结束日期的详细内容，更多请关注php中文网其它相关文章！