Home » Java » Java Reference » Java Duration Class

Java Duration Class | minusMillis() Method with Example

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

Duration Class minusMillis() method

• minusMillis() method is available in java.time package.
• minusMillis() method is used to subtract the given duration in milliseconds from this Duration and returns the Duration.
• minusMillis() 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.
• minusMillis() 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 minusMillis(long millis_val);

Parameter(s):

• long millis_val – represents the milliseconds 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 milliseconds from this Duration.

Example:

// Java program to demonstrate the example 
// of minusMillis(long millis_val) method of Duration

import java.time.*;

public class MinusMillisOfDuration {
    public static void main(String args[]) {
        long millis = 2;

        // Instantiates two Duration objects
        Duration du1 = Duration.ofMillis(5);
        Duration du2 = Duration.ofSeconds(2);

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

        System.out.println();

        // subtracts the given duration
        // in milliseconds from this Duration du1 
        // and returns the Duration i.e. here we 
        // are substracting the given 2 milliseconds
        // from this du1 that holds the value of 5 
        // milliseconds
        Duration minus_val = du1.minusMillis(millis);

        // Display minus_val
        System.out.println("du1.minusMillis(millis): " + minus_val);

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

        // Display minus_val
        System.out.println("du2.minusMillis(millis): " + minus_val);
    }
}

Output

du1: PT0.005S
du2: PT2S

du1.minusMillis(millis): PT0.003S
du2.minusMillis(millis): PT1.998S