Java中LocalDate.getDayOfWeek()返回ISO标准枚举（MONDAY=1至SUNDAY=7），但业务周统计需按自定义起始日（如周日或周三）映射为0~6偏移量，并借助WeekFields计算正确年周标识，避免硬编码和跨年错误。
Java 的 LocalDate.getDayOfWeek() 返回的是 DayOfWeek 枚举（MONDAY=1 到 SUNDAY=7），但业务中“周次统计”往往不直接对应 ISO 周定义（如周一为每周第一天、周四≥4天才算本周），而是依赖自定义起始日（例如：周日为一周开始，或按财务周从周三起算）。因此不能直接用枚举序号做统计逻辑，需先统一映射到以业务周首日为基准的“本周内偏移量”（0～6）。
明确业务周定义并构建偏移映射表
关键第一步是确定你的业务规则。例如：
- 零售行业常以 周日为每周第一天（即周日=0，周一=1，…，周六=6）
- 某些跨国企业采用 ISO 周（周一为第一天），但要求统计时以“本周四是否在当前自然周内”判定归属（ISO 周判定逻辑）
- 财务系统可能规定 周三为每周起点（即周三=0，周四=1，…，周二=6）
一旦确认起点日（firstDayOfWeek），即可建立 DayOfWeek → 业务周内序号 映射：
// 示例：以周日为每周第 0 天
Map<dayofweek integer> sundayStartOffset = Map.of(
DayOfWeek.SUNDAY, 0,
DayOfWeek.MONDAY, 1,
DayOfWeek.TUESDAY, 2,
DayOfWeek.WEDNESDAY, 3,
DayOfWeek.THURSDAY, 4,
DayOfWeek.FRIDAY, 5,
DayOfWeek.SATURDAY, 6
);</dayofweek>
将日期归入业务周，并计算周标识（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<localdate> 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
);
<p>WeekFields sundayStart = WeekFields.of(DayOfWeek.SUNDAY, 1);</p>
<p>Map<string long> weeklyCount = orderDates.stream()
.collect(Collectors.groupingBy(
d -> String.format("%d-W%02d",
d.get(sundayStart.year()),
d.get(sundayStart.weekOfYear())
),
Collectors.counting()
));</string></p>
<p>// 结果：{"2024-W22"=2, "2024-W23"=1}</p></localdate>
注意事项与避坑点
使用时务必注意以下细节：
-
不要硬编码 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 ...)），需确保传参和解析逻辑匹配
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
