java.time.Instant.plusNanos() Method Example

Description

The java.time.Instant.plusNanos(long nanosToAdd) method returns a copy of this instant with the specified duration in nanoseconds added.

Declaration

Following is the declaration for java.time.Instant.plusNanos(long nanosToAdd) method.

public Instant plusNanos(long nanosToAdd)

Parameters

nanosToAdd − the nanoseconds to add, positive or negative.

Return Value

an Instant based on this instant with the specified nanoseconds added, not null.

Exceptions

• DateTimeException − if the result exceeds the maximum or minimum instant.

• ArithmeticException − if numeric overflow occurs.

Example

The following example shows the usage of java.time.Instant.plusNanos(long nanosToAdd) method.

package com.tutorialspoint;

import java.time.Instant;

public class InstantDemo {
   public static void main(String[] args) {

      Instant instant = Instant.parse("2017-02-03T10:37:30.00Z");
      System.out.println(instant.getNano());  
      Instant result = instant.plusNanos(10000);
      System.out.println(result.getNano());   
   }
}

Let us compile and run the above program, this will produce the following result −

0
10000