JavaLocalDate获取星期几数字方法

本文深入解析了Java中LocalDate获取“周几数字”的实际业务难点——不能简单依赖DayOfWeek枚举的ISO标准值（MONDAY=1至SUNDAY=7），而需根据真实场景（如零售按周日开头、财务按周三起算）动态映射为0~6的业务内偏移量，并借助WeekFields精准计算跨年不误的年周标识（如2024-W22），辅以可复用的分组统计代码和关键避坑指南，帮你彻底规避硬编码、跨年错位、数据库语义不一致等高频陷阱。

Java 的 LocalDate.getDayOfWeek() 返回的是 DayOfWeek 枚举（MONDAY=1 到 SUNDAY=7），但业务中“周次统计”往往不直接对应 ISO 周定义（如周一为每周第一天、周四≥4天才算本周），而是依赖自定义起始日（例如：周日为一周开始，或按财务周从周三起算）。因此不能直接用枚举序号做统计逻辑，需先统一映射到以业务周首日为基准的“本周内偏移量”（0～6）。

明确业务周定义并构建偏移映射表

关键第一步是确定你的业务规则。例如：

• 零售行业常以 周日为每周第一天（即周日=0，周一=1，…，周六=6）
• 某些跨国企业采用 ISO 周（周一为第一天），但要求统计时以“本周四是否在当前自然周内”判定归属（ISO 周判定逻辑）
• 财务系统可能规定 周三为每周起点（即周三=0，周四=1，…，周二=6）

一旦确认起点日（firstDayOfWeek），即可建立 DayOfWeek → 业务周内序号 映射：

// 示例：以周日为每周第 0 天
Map sundayStartOffset = Map.of(
    DayOfWeek.SUNDAY, 0,
    DayOfWeek.MONDAY, 1,
    DayOfWeek.TUESDAY, 2,
    DayOfWeek.WEDNESDAY, 3,
    DayOfWeek.THURSDAY, 4,
    DayOfWeek.FRIDAY, 5,
    DayOfWeek.SATURDAY, 6
);

将日期归入业务周，并计算周标识（year-week）

仅靠星期几不够，还需结合日期推算“属于哪一周”。推荐方法：计算该日期所在业务周的**起始日**（LocalDate），再用其年份+第几周生成唯一周标识。

例如，以周日为起点：

• 对任意日期 date，先获取它的 DayOfWeek
• 计算距最近一个周日的天数偏移：int daysToSunday = (7 - date.getDayOfWeek().getValue()) % 7（注意：DayOfWeek.getValue() 周日=7，所以需取模调整）
• 则本周周日 = date.minusDays(daysToSunday)
• 该周标识可表示为：weekStart.getYear() + "-W" + String.format("%02d", weekStart.get(WeekFields.SUNDAY_START.weekOfYear()))

更稳健做法是使用 WeekFields（Java 8+）：

WeekFields weekFields = WeekFields.of(DayOfWeek.SUNDAY, 1); // 起点周日，最小天数1
TemporalField weekOfYear = weekFields.weekOfYear();
int year = date.get(weekFields.year());
int week = date.get(weekOfYear);
String businessWeekId = String.format("%d-W%02d", year, week);

按业务周分组统计的实际代码示例

假设有一组订单日期，需按“周日起点周”统计每周订单数：

List orderDates = Arrays.asList(
    LocalDate.of(2024, 6, 2), // 周日 → 所在周：2024-W22（6.2–6.8）
    LocalDate.of(2024, 6, 5), // 周三 → 同属 2024-W22
    LocalDate.of(2024, 6, 9)  // 下周日 → 2024-W23
);
WeekFields sundayStart = WeekFields.of(DayOfWeek.SUNDAY, 1);
Map weeklyCount = orderDates.stream()
.collect(Collectors.groupingBy(
d -> String.format("%d-W%02d",
d.get(sundayStart.year()),
d.get(sundayStart.weekOfYear())
),
Collectors.counting()
));
// 结果：{"2024-W22"=2, "2024-W23"=1}

注意事项与避坑点

使用时务必注意以下细节：

• 不要硬编码 1~7 对应周几含义：DayOfWeek.MONDAY.getValue()==1 是 ISO 定义，若业务周从周日开始，MONDAY 应是第 1 天而非第 0 天——需显式转换
• 跨年周容易出错：12月最后一周可能属于下一年的第1周（尤其 ISO 周），用 WeekFields.year() 替代 LocalDate.getYear()
• 避免用“本周一/周日”简单截断：例如 date.with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY)) 在跨月时仍正确，但需确认是否符合业务周边界定义
• 数据库交互时保持语义一致：若 SQL 层也按相同周规则聚合（如 PostgreSQL 的 EXTRACT(WEEK FROM ...)），需确保传参和解析逻辑匹配

到这里，我们也就讲完了《JavaLocalDate获取星期几数字方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！