Java中的 Instant with() 方法和示例

在 Instant 类中，根据传递给它的参数，有两种类型的 with() 方法。

with(TemporalAdjuster 调节器)

Instant类的with(TemporalAdjusteradjuster)方法用于使用 TemporalAdjuster 调整此瞬间，调整后返回调整后的瞬间副本。使用指定的调整器策略对象进行调整。 Instant 的此实例是不可变的，不受此方法调用的影响。

句法：

public Instant with(TemporalAdjuster adjuster)

参数：此方法接受调节器作为要使用的调节器的参数。

返回值：此方法基于此返回一个 Instant 并进行调整。

异常：此方法抛出以下异常：

• DateTimeException – 如果无法进行调整。
• ArithmeticException – 如果发生数字溢出。

下面的程序说明了 with() 方法：
方案一：

// 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)

Instant类的with(TemporalField field, long newValue)方法用于将 Instant 的指定字段设置为新值并返回新时间的副本。该方法可用于更改任何支持的字段，例如年、日、月、时、分或秒。如果由于不支持该字段或由于某些其他原因而无法设置新值，则会引发异常。 Instant 的此实例是不可变的，不受此方法调用的影响。

句法：

public Instant with(TemporalField field, long newValue)

参数：此方法接受作为结果中要设置的字段的字段和结果中字段的新值作为参数的newValue 。

返回值：此方法返回一个基于 this 并带有指定字段集的 Instant。

异常：此方法抛出以下异常：

• DateTimeException – 如果无法进行调整。
• UnsupportedTemporalTypeException – 如果不支持该字段。
• ArithmeticException – 如果发生数字溢出。

下面的程序说明了 with() 方法：
方案一：

// 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 Java Java)
https://docs.oracle.com/javase/10/docs/api/java Java Java, long)