Java Instant plusNanos()方法及示例

Instant类的 plusNanos() 方法将作为参数传递的纳秒值添加到这个瞬间，并将结果作为一个瞬间对象返回。这个返回的 Instant 是不可改变的。

语法

public Instant plusNanos(long nanosToAdd)

参数： 该方法接受一个参数nanosToAdd，它是要添加的纳秒数。

返回： 该方法返回Instant，而不是null。

异常： 该方法会抛出以下异常。

• DateTimeException：如果结果超过了最大或最小的瞬间。
• ArithmeticException：如果发生数字溢出。

下面的程序说明了plusNanos()方法。

程序1 :

// Java program to demonstrate
// Instant.plusNanos() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Instant object
        Instant instant
            = Instant.parse("2018-10-28T19:34:50.63Z");
  
        // addition of 840000000 nanoseconds
        // means .84 seconds to this instant
        Instant returnedValue
            = instant.plusNanos(840000000);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

输出:

Returned Instant: 2018-10-28T19:34:51.470Z

程序2

// Java program to demonstrate
// Instant.plusNanos() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Instant object
        Instant instant = Instant.now();
  
        // current Instant
        System.out.println("Current instant: "
                           + instant);
  
        // addition of 430000000 nanoseconds
        // means .43 seconds to this instant
        Instant returnedValue
            = instant.plusNanos(430000000);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

输出:

Current instant: 2018-11-28T05:32:40.818Z
Returned Instant: 2018-11-28T05:32:41.248Z

参考文献: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#plusNanos(long)