Java中周起始日跨年度时如何正确计算周起止日期？

我们通过PostgreSQL的DATE_PART函数（ISO兼容）获取周数（week）和年份（yearNo），需要根据用户指定的周起始日（比如周日），在给定的起止日期范围内计算对应周的起始与结束日期。当前代码在周起始日属于上一年最后一周时计算结果错误，以下是修正方案。

原代码问题分析 #

• Calendar API延迟计算缺陷：先设置Calendar.YEAR再设置Calendar.WEEK_OF_YEAR时，Calendar的延迟计算机制可能导致年份未正确更新，尤其当目标周实际属于相邻年份时。
• 新旧API混合的转换错误：同时使用Calendar、SimpleDateFormat和LocalDate，通过字符串截取解析日期的方式容易引入格式错误，且代码冗余。
• 自定义周起始日逻辑模糊：直接设置DAY_OF_WEEK未考虑周跨年份的场景，无法准确映射ISO周到自定义起始的周范围。

解决方案：使用Java 8+ java.time日期时间API #

java.time包专为日期时间处理设计，提供了YearWeek、WeekFields等类，能精准处理ISO周和自定义周规则，避免旧API的缺陷。

修正后的代码 #

import java.time.LocalDate;
import java.time.DayOfWeek;
import java.time.temporal.WeekFields;
import java.util.Calendar;

private String getWeek(LocalDate startTime, LocalDate endTime, int yearNo, int weekNumber, int weekStartDay) {
    // 将Calendar的周起始日常量转换为DayOfWeek枚举
    DayOfWeek startDay = switch (weekStartDay) {
        case Calendar.MONDAY -> DayOfWeek.MONDAY;
        case Calendar.TUESDAY -> DayOfWeek.TUESDAY;
        case Calendar.WEDNESDAY -> DayOfWeek.WEDNESDAY;
        case Calendar.THURSDAY -> DayOfWeek.THURSDAY;
        case Calendar.FRIDAY -> DayOfWeek.FRIDAY;
        case Calendar.SATURDAY -> DayOfWeek.SATURDAY;
        case Calendar.SUNDAY -> DayOfWeek.SUNDAY;
        default -> throw new IllegalArgumentException("无效的周起始日：" + weekStartDay);
    };

    // 定义与PostgreSQL对齐的周规则：最小4天算首周，自定义起始日
    WeekFields weekFields = WeekFields.of(startDay, 4);
    // 构造对应PostgreSQL返回的ISO周实例
    java.time.YearWeek yearWeek = java.time.YearWeek.of(yearNo, weekNumber);

    // 计算自定义起始日的周起始日期
    LocalDate weekStart = yearWeek.atDay(startDay);
    // 计算周结束日期（起始日加6天）
    LocalDate weekEnd = weekStart.plusDays(6);

    // 与给定的起止日期做截断处理，避免超出范围
    if (weekStart.isBefore(startTime)) {
        weekStart = startTime;
    }
    if (weekEnd.isAfter(endTime)) {
        weekEnd = endTime;
    }

    return weekStart.toString() + "_" + weekEnd.toString();
}

代码说明 #

• 自定义周规则对齐：通过WeekFields.of(startDay, 4)设置与PostgreSQL一致的周计算规则（首周至少包含4天），确保周数和年份的映射逻辑完全匹配。
• YearWeek精准表示ISO周：直接用YearWeek.of(yearNo, weekNumber)构造对应PostgreSQL返回的周，彻底避免Calendar的年份错位问题。
• 周起止日期计算：通过yearWeek.atDay(startDay)直接获取自定义起始日的周起始日期，加6天得到结束日期，跨年份的周能自动正确映射到对应日期范围。
• 边界处理：保留原逻辑，将计算出的周起止日期与用户给定的startTime、endTime做截断，避免超出指定范围。

边界场景测试示例 #

比如2025年第1周（ISO周），周起始日为周日：

• ISO周2025-W01对应的自定义周日起始周，起始日期为2024-12-29，结束日期为2025-01-04，修正后的代码能正确计算该跨年份的周范围。

内容的提问来源于stack exchange，提问作者avanish rai