The plusNanos() method of Instant class adds nanoseconds value passed as parameter to this instant and return the result as an instant object. This returned Instant is immutable.
Syntax:
public Instant plusNanos(long nanosToAdd)
Parameters: This method accepts one parameter nanosToAdd which is nanoseconds to be added.
Returns: This method returns Instant, not null.
Exception: This method throws following exceptions:
- DateTimeException: if the result exceeds the maximum or minimum instant.
- ArithmeticException: if numeric overflow occurs.
Below programs illustrate the plusNanos() method:
Program 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);    }} |
Output:
Returned Instant: 2018-10-28T19:34:51.470Z
Program 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);    }} |
Output:
Current instant: 2018-11-28T05:32:40.818Z Returned Instant: 2018-11-28T05:32:41.248Z
References: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#plusNanos(long)
… [Trackback]
[…] Info on that Topic: geeksforgeeks.org/instant-plusnanos-method-in-java-with-examples-2/ […]