Java中的 YearMonth with() 方法及示例

简介

在Java 8中，引入了新的日期库java.time。YearMonth是一个日期时间类，表示年月信息，提供了许多方便的方法来处理年月信息。其中with()方法是其中一个重要的方法。

with() 方法的作用

with()方法是修改日期时间对象某一字段的方法。YearMonth中提供了许多可修改的字段，例如年份（year）和月份（month）。with()方法会返回一个新的YearMonth对象。

public YearMonth with(TemporalField field,long newValue)

"field"为需要修改的字段，"newValue"为修改后的新值。具体来说，有以下字段可供修改：

• YEAR: 年份，支持int类型值。
• MONTH_OF_YEAR: 月份，支持int类型值。

示例

以下是几个示例，展示如何使用with()方法来修改YearMonth对象的字段。

修改年份

YearMonth yearMonth = YearMonth.parse("2022-01");
System.out.println(yearMonth); // 2022-01

YearMonth newYearMonth = yearMonth.with(ChronoField.YEAR, 2023);
System.out.println(newYearMonth); // 2023-01

在该示例中，我们首先创建一个YearMonth对象，表示2022年1月。然后我们使用with()方法来修改该对象的年份字段，使之变为2023年。with()方法返回一个新的YearMonth对象，我们将其保存在一个新的变量中。最后，我们打印出新的YearMonth对象，确认其成功修改。

修改月份

YearMonth yearMonth = YearMonth.parse("2022-01");
System.out.println(yearMonth); // 2022-01

YearMonth newYearMonth = yearMonth.with(ChronoField.MONTH_OF_YEAR, 2);
System.out.println(newYearMonth); // 2022-02

在该示例中，我们同样创建一个YearMonth对象，表示2022年1月。然后我们使用with()方法来修改该对象的月份字段，使之变为2月。同样地，with()方法返回一个新的YearMonth对象，我们将其保存在一个新的变量中。最后，我们打印出新的YearMonth对象，确认其成功修改。

注意事项

• with()方法返回的是一个新的对象，原始对象并不会被修改。
• 如果修改后的年份或月份不合法，会抛出DateTimeException异常。