Instant minusMillis() method in Java with Examples

The minusMillis() method of Instant class subtracts specified duration in milliseconds from this instant and returns the result as an instant object. This returned Instant is immutable.

Syntax:

public Instant minusMillis(long millisToSubtract)

Parameters: This method accepts one parameter millisToSubtract which is milliseconds to subtract.

Returns: This method returns the Instant after subtraction of milliSeconds.

Exception: This method throws following exceptions:

• DateTimeException: if the result exceeds the maximum or minimum instant.
• ArithmeticException: if numeric overflow occurs.

Below programs illustrate the minusMillis() method:

Program 1:

// Java program to demonstrate
// Instant.minusMillis() method

import java.time.*;

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

        // create a Instant object
        Instant instant
            = Instant.parse("2018-12-30T19:34:50.63Z");

        // subtract 64000000 MILLI_OF_SECOND
        // means 64000 seconds from this instant
        Instant returnedValue
            = instant.minusMillis(64000000);

        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

Output:

Returned Instant: 2018-12-30T01:48:10.630Z

Program 2:

// Java program to demonstrate
// Instant.minusMillis() method

import java.time.*;

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

        // create a Instant object
        Instant instant = Instant.now();

        // current Instant
        System.out.println("current instant: "
                           + instant);

        // subtract 36000000 MILLI_OF_SECOND
        // means 36000 seconds from this instant
        Instant returnedValue
            = instant.minusMillis(36000000);

        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

Output:

current instant: 2018-11-27T05:13:12.132Z
Returned Instant: 2018-11-26T19:13:12.132Z

References: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#minusMillis(long)