Home » Java » Java Reference » Java Duration Class

Java Duration Class | plusNanos() Method with Example

Duration Class plusNanos() method: Here, we are going to learn about the plusNanos() method of Duration Class with its syntax and example.
Submitted by Preeti Jain, on May 17, 2020

Duration Class plusNanos() method

• plusNanos() method is available in java.time package.
• plusNanos() method is used to add the given duration in nanoseconds to this Duration and return the Duration.
• plusNanos() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• plusNanos() method may throw an exception at the time of performing addition.
  ArithmeticException: This exception may throw when the calculated results exceed the length of this Duration.

Syntax:

    public Duration plusNanos(long nanos_val);

Parameter(s):

• long nanos_val – represents the nanoseconds value to add to this Duration.

Return value:

The return type of this method is Duration, it returns the Duration that holds the value added the given nanoseconds to this Duration.

Example:

// Java program to demonstrate the example 
// of plusNanos(long nanos_val) method of Duration

import java.time.*;

public class PlusNanosOfDuration {
    public static void main(String args[]) {
        long nanos = 2000;

        // Instantiates two Duration objects
        Duration du1 = Duration.ofNanos(3000);
        Duration du2 = Duration.ofSeconds(2);

        // Display du1, du2 
        System.out.println("du1: " + du1);
        System.out.println("du2: " + du2);
        System.out.println("nanos to add: " + nanos);

        System.out.println();

        // adds the given duration in nanoseconds from 
        // this Duration du1 and returns the Duration 
        // i.e. here we are adding the given 2000 nanos
        // with this du1 that holds the value of 
        // 3000 nanoseconds
        Duration plus_val = du1.plusNanos(nanos);

        // Display plus_val
        System.out.println("du1.plusNanos(nanos): " + plus_val);

        // adds the given duration in nanoseconds with 
        // this Duration du2 and returns the Duration 
        // i.e. here we are adding the given 2000 nanos
        // with this du2 that holds the value of 
        // 2 seconds
        plus_val = du2.plusNanos(nanos);

        // Display plus_val
        System.out.println("du2.plusNanos(nanos): " + plus_val);
    }
}

Output

du1: PT0.000003S
du2: PT2S
nanos to add: 2000

du1.plusNanos(nanos): PT0.000005S
du2.plusNanos(nanos): PT2.000002S