Java Instant with()方法及实例

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)

Python教程

Java教程

Web教程

数据库教程

图形图像教程

大数据教程

开发工具教程

计算机教程