Duration minusMillis(long) method in Java with Examples

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

Syntax:

public Duration minusMillis(long numberOfMillis)

Parameters: This method accepts a parameter numberOfMillis which is the number of milliseconds to be subtracted. 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 milli-seconds subtracted to it.

Exception: This method throws ArithmeticException if numeric overflow occurs.

Below examples illustrate the Duration.minusMillis() method:

Example 1:

Java

// Java code to illustrate minusMillis() 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 subtracted
        // using minusMillis() method
        System.out.println(duration1.minusMillis(2));
    }
}

Output:

PT51H3M59.998S

Example 2:

Java

// Java code to illustrate minusMillis() 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 subtracted
        // using minusMillis() method
        System.out.println(duration1.minusMillis(5));
    }
}

Output:

PT3M59.995S

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