Duration plusNanos(long) method in Java with Examples

The plusNanos(long) method of Duration Class in java.time package is used to get an immutable copy of this duration with the specified number of nano-seconds added, passed as the parameter.

Syntax:

public Duration plusNanos(long numberOfNanos)

Parameters: This method accepts a parameter numberOfNanos which is the number of nano-seconds to be added. It can be positive or negative but not null.

Return Value: This method returns a Duration which is an immutable copy of the existing duration with the parameter amount of nano-seconds added to it.

Exception: This method throws ArithmeticException if numeric overflow occurs.

Below examples illustrate the Duration.plusNanos() method:

Example 1:

// Java code to illustrate plusNanos() method

import java.time.Duration;

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

        // Duration 1 using parse() method
        Duration duration1
            = Duration.parse("P2DT3H4M");

        // Get the duration added
        // using plusNanos() method
        System.out.println(duration1.plusNanos(2));
    }
}

Output:

PT51H4M0.000000002S

Example 2:

// Java code to illustrate plusNanos() method

import java.time.Duration;

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

        // Duration 1 using parse() method
        Duration duration1
            = Duration.parse("P0DT0H4M");

        // Get the duration added
        // using plusNanos() method
        System.out.println(duration1.plusNanos(5));
    }
}

Output:

PT4M0.000000005S

Reference: https://docs.oracle.com/javase/9/docs/api/java/time/Duration.html#plusNanos-long-