Home » Java » Java Reference » Java Duration Class

Java Duration Class | minusNanos() Method with Example

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

Duration Class minusNanos() method

• minusNanos() method is available in java.time package.
• minusNanos() method is used to subtract the given duration in nanoseconds from this Duration and returns the Duration.
• minusNanos() 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.
• minusNanos() method may throw an exception at the time of performing subtraction.
  ArithmeticException: This exception may throw when the calculated result value exceeds the limit.

Syntax:

    public Duration minusNanos(long nanos_val);

Parameter(s):

• long nanos_val – represents the nanoseconds to be subtracted from this Duration.

Return value:

The return type of this method is Duration, it returns the Duration that holds the value subtracted the given duration in nanoseconds from this Duration.

Example:

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

import java.time.*;

public class MinusNanosOfDuration {
    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 subtract: " + nanos);

        System.out.println();

        // subtracts the given duration
        // in nanoseconds from this Duration du1 
        // and returns the Duration i.e. here we 
        // are substracting the given 2000 nanos
        // from this du1 that holds the value of 
        // 3000 nanoseconds
        Duration minus_val = du1.minusNanos(nanos);

        // Display minus_val
        System.out.println("du1.minusNanos(nanos): " + minus_val);

        // subtracts the given duration
        // in nanoseconds from this Duration du2 
        // and returns the Duration i.e. here we 
        // are substracting the given 2000 nanos
        // from this du2 that holds the value of  
        // 2 seconds
        minus_val = du2.minusNanos(nanos);

        // Display minus_val
        System.out.println("du2.minusNanos(nanos): " + minus_val);
    }
}

Output

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

du1.minusNanos(nanos): PT0.000001S
du2.minusNanos(nanos): PT1.999998S