极客教程Java Instant with()方法及实例
在Instant类中，根据传递给它的参数，有两种类型的with()方法。
with(TemporalAdjuster adjuster)
instant 类的 with(TemporalAdjuster adjuster) 方法用于使用TemporalAdjuster调整这个Instant，调整后返回调整后的Instant的副本，调整是使用指定的调整策略对象进行的。Instant的这个实例是不可改变的，不受这个方法调用的影响。
语法
public Instant with(TemporalAdjuster adjuster)
参数： 该方法接受 调整器 作为参数，它是要使用的调整器。
返回值： 该方法返回一个基于此的即时调整值。
异常： 该方法抛出以下异常。
- DateTimeException – 如果不能进行调整。
- ArithmeticException – 如果发生数字溢出。
下面的程序说明了with()方法：
程序1 :
// Java program to demonstrate
// Instant.with() method
import java.time.*;
import java.time.temporal.*;
public class GFG {
public static void main(String[] args)
{
// create a Instant object
Instant local
= Instant.parse(
"2018-12-30T19:34:50.63Z");
// print instance
System.out.println("Instant before"
+ " adjustment: "
+ local);
// apply with method of Instant class
Instant updatedlocal
= local.with(Instant.EPOCH);
// print instance
System.out.println("Instant after"
+ " adjustment: "
+ updatedlocal);
}
}
输出:
Instant before adjustment: 2018-12-30T19:34:50.630Z
Instant after adjustment: 1970-01-01T00:00:00Z
with(TemporalField field, long newValue)
with(TemporalField field, long newValue) 方法用于将 Instant 的指定字段设置为一个新值，并返回新时间的副本。如果由于该字段不被支持或其他原因而无法设置新值，则会抛出一个异常。Instant的这个实例是不可改变的，不受这个方法调用的影响。
语法
public Instant with(TemporalField field, long newValue)
参数： 该方法接受 field （在结果中设置的字段）和 newValue （在结果中该字段的新值）作为参数。
返回值： 该方法在此基础上返回一个指定字段设置的即时值。
异常： 这个方法会抛出以下异常。
- DateTimeException – 如果不能进行调整。
- UnsupportedTemporalTypeException – 如果该字段不被支持。
- ArithmeticException – 如果发生数字溢出。
以下程序说明了with()方法：
程序1 :
// Java program to demonstrate
// Instant.with() method
import java.time.*;
import java.time.temporal.*;
public class GFG {
public static void main(String[] args)
{
// create a Instant object
Instant local
= Instant.parse(
"2021-01-01T19:55:30Z");
// print instance
System.out.println("Instant before"
+ " applying method: "
+ local);
// apply with method of Instant class
Instant updatedlocal
= local.with(
ChronoField.INSTANT_SECONDS,
45000000000);
// print instance
System.out.println("Instant after"
+ " applying method: "
+ updatedlocal);
}
}
输出:
Instant before applying method: 2021-01-01T19:55:30Z
Instant after applying method: 1970-01-01T00:00:45Z
参考文献：
https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#with(java.time.temporal.TemporalAdjuster)
https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#with(java.time.temporal.TemporalField, long)