java LocalDate.getDayOfMonth/getDayOfYear/getDayOfWeek返回当月中的天数

1. getDayOfMonth()

• 方法定义

  public int getDayOfMonth()
  

• 功能说明
  返回日期在当月中的天数（范围：1–31）。
• 示例代码

  LocalDate date = LocalDate.of(2023, 12, 25);
  int day = date.getDayOfMonth(); // 返回 25
  

• 使用场景
  生成账单日期、计算当月截止日等。
• 注意事项
  结果与月份长度相关（如 2 月最多 29 天）。

2. getDayOfYear()

• 方法定义

  public int getDayOfYear()
  

• 功能说明
  返回日期在当前年份中的天数（范围：1–366，闰年 366 天）。
• 示例代码

  LocalDate date = LocalDate.parse("2024-02-29"); // 闰年
  int dayOfYear = date.getDayOfYear(); // 返回 60（31 + 29）
  

• 使用场景
  计算年度进度、生成季度报告等。
• 常见错误
  忽略闰年影响（如 2023 年 12 月 31 日返回 365，2024 年同日期返回 366）。

3. getDayOfWeek()

• 方法定义

  public DayOfWeek getDayOfWeek()
  

• 功能说明
  返回 DayOfWeek 枚举值（MONDAY 到 SUNDAY），表示星期几。
• 示例代码

  LocalDate date = LocalDate.of(2023, 12, 25);
  DayOfWeek weekday = date.getDayOfWeek(); // 返回 DayOfWeek.MONDAY
  String name = weekday.name();           // "MONDAY"
  int value = weekday.getValue();         // 1 (星期一) 到 7 (星期日)
  

• 使用技巧
  • 比较星期：date.getDayOfWeek() == DayOfWeek.SATURDAY
  • 获取本地化名称：

    String cnName = weekday.getDisplayName(TextStyle.FULL, Locale.CHINA); // "星期一"
    

关键注意事项与最佳实践

1. 不可变性
   所有方法均不修改原对象，返回新值：

   LocalDate date = LocalDate.now();
   int day = date.getDayOfMonth(); // 安全，date 不变
   

2. 空指针安全
   LocalDate 不可为 null，否则抛出 NullPointerException：

   // 错误示例
   LocalDate date = null;
   int day = date.getDayOfMonth(); // NPE!
   

3. 闰年处理
   使用 Year.isLeap(year) 显式检查闰年：

   boolean isLeap = Year.of(2024).isLeap(); // true
   

4. 性能优化

   • 多次调用同一日期的 getDayOfXxx() 时，缓存结果（虽然方法本身轻量）。
   • 避免在循环中重复创建 LocalDate 对象。

5. 时区影响
   LocalDate 无时区概念，需确保业务逻辑与预期时区一致：

   LocalDate today = LocalDate.now(ZoneId.of("Asia/Shanghai"));
   

总结与快速实践指南

实践建议：

• 优先使用 DayOfWeek 枚举而非数字，增强可读性。
• 结合 TemporalAdjusters 处理复杂日期逻辑（如下个周一）：

  LocalDate nextMonday = date.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
  

• 始终校验日期合法性（如 2023-02-30 会抛出 DateTimeException）。