Java 8 Date API：深挖`LocalDate.plusWeeks(1)`方法的使用及潜在“陷阱”

这里写目录标题

引言
方法介绍
潜在“陷阱”与注意事项
- 1. 对于跨越月份和年份边界的情况
- 2. ISO周定义的影响
- 3. 时间区间的理解和使用
正确使用与规避“陷阱”
结语

引言

在Java 8中，日期时间API进行了全面改革，引入了新的java.time包，其中的LocalDate类提供了一种强大且直观的方式来处理日期。今天我们要深入探讨的是LocalDate中的plusWeeks(1)方法，它允许我们轻松地将日期向前或向后推算指定的周数。但在实际应用中，如果不充分理解其行为机制，可能会遇到一些意想不到的问题，这就是我们今天要一起“闭坑”的内容。

方法介绍

LocalDate.plusWeeks(int weeks)是Java 8新日期时间API中的一个重要方法，其作用是在当前日期基础上增加指定的周数。例如：

// CSDN小小野猪
LocalDate currentDate = LocalDate.now();
LocalDate nextWeekDate = currentDate.plusWeeks(1);

上述代码将获取当前日期，并将其向后推算一周，生成下一周的日期。

潜在“陷阱”与注意事项

1. 对于跨越月份和年份边界的情况

plusWeeks方法会严格根据日历计算下一个周的日期，这意味着如果当前日期位于一个月的最后一周，那么增加一周可能就会导致跨月。同样，如果处于一年的最后一周，增加一周则可能跨越到下一年。

闭坑点1：跨越周末根据ISO-8601标准，一周从周一开始，到周日结束。因此，如果你在一个星期五调用plusWeeks(1)，它不会返回下个周五，而是返回下周一。这是因为它计算的是完整的ISO周，而不是简单的七天间隔。

LocalDate friday = LocalDate.of(2022, Month.JANUARY, 28);
LocalDate nextMonday = friday.plusWeeks(1);
System.out.println(nextMonday); // 输出：2022-02-07（而非2022-02-04）

闭坑点2：年末年初边界同样的，当一个日期处于一年的最后一周，且该周不完全属于新的一年时，plusWeeks(1)会进入新的一年，即使只增加了几天。

LocalDate newYearsEve = LocalDate.of(2022, Month.DECEMBER, 30);
LocalDate firstDayOfYear = newYearsEve.plusWeeks(1);
System.out.println(firstDayOfYear); // 输出：2023-01-03（而非仍在2022年内）

闭坑点3：假设当前日期是2024年12月31日，那么date.plusWeeks(1)后的日期将是2025年1月7日。在这种情况下，date.getYear()将返回2025。然而，如果当前日期是2024年12月25日，那么date.plusWeeks(1)后的日期将是2025年1月1日。在这种情况下，date.getYear()仍然返回2024，因为这是原始日期的年份。会造成一个问题，就是年份为2024年，周开始日期为2024-12-30时，打印出的周数是1，这样不太对，应该打印为2025年的第一周。