Java YearMonth 怎么得到当月最后一天并处理闰年

做月度账期时，最容易出错的地方不是格式化，而是“这个月到底有几天”。Java 不需要自己写二月判断：先用 YearMonth 表达一个没有具体日的年月，再调用 atEndOfMonth() 得到月末的 LocalDate。2024 年 2 月会得到 29 日，2023 年 2 月会得到 28 日，闰年规则由日期 API 处理。

官方文档：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/time/YearMonth.html

先确认问题：年月不应该先拼成某一天

YearMonth 只表示年和月，不保存日、时间或时区。它适合“2024 年 2 月账期”这种业务对象；如果一开始就把输入拼成 2024-02-01，后续代码很容易把第一天误当成月份对象，再手动推算月末。

月末的最短写法是：

import java.time.LocalDate;
import java.time.YearMonth;

public class MonthEndDemo {
    public static void main(String[] args) {
        // YearMonth 表示自然月，不把无意义的“1号”混入业务语义。
        YearMonth billingMonth = YearMonth.of(2024, 2);

        // atEndOfMonth 会根据该年月返回最后一天的 LocalDate。
        LocalDate monthEnd = billingMonth.atEndOfMonth();
        System.out.println(monthEnd); // 2024-02-29
    }
}

动手验证：atEndOfMonth 如何处理闰年二月

验证时不要只看一个月份，至少把闰年二月、平年二月和 4 月放在一起。这样能确认代码依赖的是月份长度规则，而不是偶然得到某个固定日期。

import java.time.YearMonth;
import java.util.List;

public class LeapYearCheck {
    public static void main(String[] args) {
        // 同时覆盖闰年二月、平年二月和 30 天月份。
        List months = List.of(
                YearMonth.of(2024, 2),
                YearMonth.of(2023, 2),
                YearMonth.of(2024, 4)
        );

        for (YearMonth month : months) {
            // lengthOfMonth 由 YearMonth 的年份和月份共同决定。
            System.out.printf("%s: %d days, end=%s, leap=%s%n",
                    month,
                    month.lengthOfMonth(),
                    month.atEndOfMonth(),
                    month.isLeapYear());
        }
    }
}

对应关系是：2024-02 有 29 天且是闰年，2023-02 有 28 天且不是闰年，2024-04 有 30 天且不是闰年。注意 isLeapYear() 只说明年份是否为闰年，不直接返回月末日期。

定位原因：不要把 lengthOfMonth 当成月末日期

lengthOfMonth() 返回的是整数天数，例如 29；atEndOfMonth() 返回的是带年月日的 LocalDate，例如 2024-02-29。前者适合统计和展示，后者适合和账单日期、查询条件或序列化结果对接。

修复方案：从文本输入安全得到月末

如果月份来自表单或配置文件，可以让 YearMonth.parse() 负责解析标准的 uuuu-MM 文本。解析失败时捕获日期解析异常，避免把不完整的字符串静默变成错误账期。

import java.time.YearMonth;
import java.time.format.DateTimeParseException;

public class ParseMonthEnd {
    static String monthEndText(String text) {
        try {
            // parse 只接受合法的年月文本，例如 2024-02。
            YearMonth month = YearMonth.parse(text);
            // 返回 ISO 日期文本，便于日志或接口传输。
            return month.atEndOfMonth().toString();
        } catch (DateTimeParseException ex) {
            // 输入错误要显式暴露，不能用当前月份替代用户输入。
            throw new IllegalArgumentException("月份格式应为 uuuu-MM: " + text, ex);
        }
    }
}

这里的“合法”是自然月合法，不等于业务规则合法。比如结算系统还可能要求账期不能早于合同生效日，这应该在得到月末日期之后单独判断。

验证结果：测试时钟和自然月末要分开

如果代码还需要“当前月份”，可以使用 YearMonth.now(clock) 注入测试时钟，再调用 atEndOfMonth()。直接使用无参数的 now() 会读取系统时钟，测试跨月时不够稳定。

import java.time.Clock;
import java.time.Instant;
import java.time.ZoneOffset;
import java.time.YearMonth;

public class ClockMonthEnd {
    public static void main(String[] args) {
        // 固定时刻让跨月测试可重复，生产代码可传入系统时钟。
        Clock clock = Clock.fixed(
                Instant.parse("2024-02-15T00:00:00Z"),
                ZoneOffset.UTC);

        // 从注入的时钟得到年月，再计算自然月末。
        YearMonth current = YearMonth.now(clock);
        System.out.println(current.atEndOfMonth()); // 2024-02-29
    }
}

最后再区分一个常见边界：自然月最后一天不一定是工作日。YearMonth 能解决月份长度和闰年问题，但节假日、调休、工作日顺延需要另外的日历数据或业务规则，不能把它们混进 atEndOfMonth() 的职责。

小结：用对象表达月份，月末交给日期 API

月末计算可以固定成三步：用 YearMonth.of() 或 parse() 得到年月；用 atEndOfMonth() 得到 LocalDate；需要解释结果时再读取 lengthOfMonth() 和 isLeapYear()。这样既覆盖闰年二月，也避免维护容易漏掉边界的手写天数表。

相关问题

YearMonth 能直接保存时分秒吗？

不能。它只表达年和月；需要时间和时区时，应根据业务选择 LocalDateTime、ZonedDateTime 等类型。

为什么不直接用 LocalDate.of(year, month, 31)？

因为 31 日并非每个月都存在，二月和 30 天月份会抛出日期异常。先用 atEndOfMonth() 得到有效日期更稳妥。

atEndOfMonth() 会考虑法定节假日吗？

不会。它只计算 ISO 日历下的自然月末；工作日和节假日需要独立的数据源与规则。