ZonedDateTime plusNanos() method in Java with Examples

plusNanos() method of a ZonedDateTime class used to add the number of nanoseconds in this ZonedDateTime and return a copy of ZonedDateTime after addition.This method works on the instant time-line and adding one nanosecond return the time-line of one nanosecond later. Note that this method is a different approach to that used by days, months and years. This instance is immutable and unaffected by this method call.

Syntax:

public ZonedDateTime plusNanos(long nanoseconds)

Parameters: This method accepts a single parameter nanoseconds which represents the nanoseconds to add, It can be negative.

Return value: This method returns a ZonedDateTime based on this date-time with the nanoseconds added.

Exception: This method throws DateTimeException if the result exceeds the supported date range.

Below programs illustrate the plusNanos() method:
Program 1:

// Java program to demonstrate
// ZonedDateTime.plusNanos() method

import java.time.*;

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

        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");

        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding nanoseconds: "
                           + zoneddatetime);

        // add 30000000 nanoseconds
        ZonedDateTime returnvalue
            = zoneddatetime.plusNanos(30000000);

        // print result
        System.out.println("ZonedDateTime after "
                           + " adding nanoseconds: "
                           + returnvalue);
    }
}

Output:

ZonedDateTime before adding nanoseconds: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta]
ZonedDateTime after adding nanoseconds: 2018-12-06T19:21:12.153+05:30[Asia/Calcutta]

Program 2:

// Java program to demonstrate
// ZonedDateTime.plusNanos() method

import java.time.*;

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

        // create a ZonedDateTime object
        ZonedDateTime zoneddatetime
            = ZonedDateTime.parse(
                "2018-10-25T23:12:31.123+02:00[Europe/Paris]");

        // print instance
        System.out.println("ZonedDateTime before"
                           + " adding nanoseconds: "
                           + zoneddatetime);

        // add 5200000 nanoseconds
        ZonedDateTime returnvalue
            = zoneddatetime.plusNanos(5200000);

        // print result
        System.out.println("ZonedDateTime after "
                           + " adding nanoseconds: "
                           + returnvalue);
    }
}

Output:

ZonedDateTime before adding nanoseconds: 2018-10-25T23:12:31.123+02:00[Europe/Paris]
ZonedDateTime after adding nanoseconds: 2018-10-25T23:12:31.128200+02:00[Europe/Paris]

Reference: https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#plusNanos(long)