Java YearMonth with()方法及示例
在YearMonth类中,根据传递给它的参数,有两种类型的with()方法。
with(TemporalAdjuster adjuster)
YearMonth 类的 with(TemporalAdjuster adjuster) 方法用于使用TemporalAdjuster调整这个YearMonth,调整后返回调整后的YearMonth的副本。YearMonth的这个实例是不可改变的,不受这个方法调用的影响。
语法
public YearMonth with(TemporalAdjuster adjuster)
参数: 该方法接受 调整器 作为参数,它是要使用的调整器。
返回值: 该方法在此基础上返回一个经过调整的YearMonth。
异常: 该方法抛出以下异常。
- DateTimeException – 如果不能进行调整。
- ArithmeticException – 如果发生数字溢出。
以下程序说明了with()方法:
程序1 :
// Java program to demonstrate
// YearMonth.with() method
import java.time.*;
import java.time.temporal.*;
public class GFG {
public static void main(String[] args)
{
// create a YearMonth object
YearMonth yr
= YearMonth.of(2019, 12);
// print instance
System.out.println("YearMonth before"
+ " adjustment: "
+ yr);
// apply with method of YearMonth class
YearMonth updatedlocal
= yr.with(YearMonth.of(2012, 12));
// print instance
System.out.println("YearMonth after"
+ " adjustment: "
+ updatedlocal);
}
}
输出。
YearMonth before adjustment: 2019-12
YearMonth after adjustment: 2012-12
with(TemporalField field, long newValue)
YearMonth 类的 with(TemporalField field, long newValue) 方法用于将YearMonth的指定字段设置为一个新值,并返回新时间的副本。这个方法可以用来改变任何支持的字段,如年或月。如果由于该字段不被支持或其他原因而无法设置新值,则会抛出一个异常。YearMonth的这个实例是不可改变的,不受这个方法调用的影响。
语法
public YearMonth with(TemporalField field, long newValue)
参数: 该方法接受 field 和 newValue 作为参数,前者是要在结果中设置的字段,后者是结果中该字段的新值。
返回值: 该方法返回一个基于指定字段设置的YearMonth。
异常: 这个方法会抛出以下异常。
- DateTimeException – 如果不能进行调整。
- UnsupportedTemporalTypeException – 如果该字段不被支持。
- ArithmeticException – 如果发生数字溢出。
以下程序说明了with()方法:
程序1 :
// Java program to demonstrate
// YearMonth.with() method
import java.time.*;
import java.time.temporal.*;
public class GFG {
public static void main(String[] args)
{
// create a YearMonth object
YearMonth yr
= YearMonth.of(2019, 12);
// print instance
System.out.println("YearMonth before"
+ " applying method: "
+ yr);
// apply with method of YearMonth class
YearMonth updatedlocal
= yr.with(ChronoField.YEAR, 2100);
// print instance
System.out.println("YearMonth after"
+ " applying method: "
+ updatedlocal);
}
}
输出。
YearMonth before applying method: 2019-12
YearMonth after applying method: 2100-12
参考文献:
https://docs.oracle.com/javase/10/docs/api/java/time/YearMonth.html#with(java.time.temporal.TemporalAdjuster)
https://docs.oracle.com/javase/10/docs/api/java/time/YearMonth.html#with(java.time.temporal.TemporalField, long)