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