Java获取本周周一和周日的实现方法

本文深入剖析了Java中获取当前周周一和周末日期的常见误区与最佳实践，指出直接使用Calendar.get(WEEK_OF_YEAR)因Locale依赖和跨年逻辑而极不可靠；强调应通过锚定当前日期、结合DAY_OF_WEEK偏移推算周一和周六（或周日）的稳健思路，并警示SimpleDateFormat解析会清零时分秒、Calendar.set()后必须调用getTime()触发内部重算等易踩坑点；最后强烈推荐Java 8+项目采用不可变、语义清晰的LocalDate配合TemporalAdjusters实现，兼顾准确性、可读性与可维护性——真正棘手的不是计算本身，而是厘清“本周”在不同上下文中的统计边界与时间语义。

Calendar.get() 返回的 WEEK_OF_YEAR 不可靠

用 Calendar 算周一/周日，很多人第一反应是调 get(WEEK_OF_YEAR) 再配合 set(WEEK_OF_YEAR, ...)，结果发现跨年时日期乱跳、12月最后一周算成下一年第1周。这是因为 WEEK_OF_YEAR 依赖 getFirstDayOfWeek() 和 getMinimalDaysInFirstWeek()，不同 Locale 默认值不同（比如 US 是 Sunday 开头、Minimal=1，CHINA 是 Monday 开头、Minimal=4），直接操作它本质是在“按周编号”维度推算，不是“找本周起止日期”。

正确做法是：先锚定当前日期，再往回/往前推到最近的周一和周日。

• 用 cal.get(Calendar.DAY_OF_WEEK) 获取今天是星期几（注意：SUNDAY=1, MONDAY=2, ..., SATURDAY=7）
• 往回减 (dayOfWeek - Calendar.MONDAY) 天得周一
• 往后加 (Calendar.SATURDAY - dayOfWeek) 天得周六（注意：不是周日！Calendar 的“周末”在业务中常指周六+周日，但“本周六”才是严格对应周一的结束日）
• 如果真要周日，就再加 1 天；但需意识到：周日属于下一周的 WEEK_OF_YEAR

SimpleDateFormat 解析后 set() 会丢掉时分秒

有人先用 SimpleDateFormat 格式化当前时间字符串，再 parse 回 Date，接着塞进 Calendar 里 set 时间字段——这会导致时分秒被清零。因为 SimpleDateFormat 默认只解析到你指定的格式部分，没写的就补 0。

例如：new SimpleDateFormat("yyyy-MM-dd").parse("2024-06-10") 得到的是当天 00:00:00 的 Date，再 set 到 Calendar 就永远从零点开始算偏移。

• 想保留原始时间的时分秒？别 parse 字符串，直接 clone 当前 Calendar 实例
• 用 Calendar cal = Calendar.getInstance(); Calendar base = (Calendar) cal.clone();
• 所有推算都在 base 上做，原始 cal 的时分秒不受影响

Calendar.set() 后必须调用 Calendar.getTime() 才生效

Calendar 是可变对象，但它的内部时间戳（timeInMillis）不会在每次 set() 后自动更新。如果你只 set 年月日，没调 getTime() 或 get() 触发计算，后续再 get 其他字段（比如 HOUR_OF_DAY）可能返回旧值或错误值。

典型现象：设完周一日期后直接打印 format.format(cal.getTime())，结果还是原来的小时分钟——因为 getTime() 强制触发了内部重算。

• 每次完成日期字段修改后，立刻调一次 cal.getTime()（哪怕不存结果）
• 或者统一在最后一步调，但确保中间没混用未刷新的字段 get 操作
• 避免链式写法如 cal.set(...).set(...).getTime() —— set() 返回 void

LocalDate + TemporalAdjusters 更安全（Java 8+）

如果项目已用 Java 8+，硬啃 Calendar 不仅容易错，还难测。用 LocalDate 配合 TemporalAdjusters 是更直白的选择：语义清晰、不可变、无时区干扰。

例如获取本周一：LocalDate.now().with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY))；本周日：.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY))。

• previousOrSame 和 nextOrSame 能处理“今天就是周一/周日”的边界情况
• 不依赖默认时区，LocalDate.now() 默认用系统时区，但你可以显式传 ZoneId.systemDefault() 或 ZoneOffset.UTC
• 如果必须返回 Date，用 localDate.atStartOfDay(ZoneId.systemDefault()).toInstant().toEpochMilli() 转，别用过时的 GregorianCalendar.from()

真正麻烦的从来不是“怎么算出周一”，而是“算出来之后，这个周一到底属于哪一周的统计周期”。Calendar 的模糊性在这里暴露得最彻底——它既像一个时间容器，又像一个日历规则引擎，而这两者在跨年、跨月、时区切换时根本无法解耦。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~