Instant minusMillis() method in Java

An immutable copy of a instant where some milliseconds are subtracted from it can be obtained using the minusMillis() method in the Instant class in Java. This method requires a single parameter i.e. the number of milliseconds to be subtracted and it returns the instant with the subtracted milliseconds.

A program that demonstrates this is given as follows −

Example

 Live Demo

import java.time.*;
public class Demo {
   public static void main(String[] args) {
      Instant i = Instant.now();
      System.out.println("The current instant is: " + i);
      System.out.println("An instant with 1000 milliseconds subtracted is: " + i.minusMillis(1000));
   }
}

Output

The current instant is: 2019-02-12T12:33:09.648Z
An instant with 1000 milliseconds subtracted is: 2019-02-12T12:33:08.648Z

Now let us understand the above program.

First, the current instant is displayed. Then an immutable copy of the instant where 1000 milliseconds are subtracted is obtained using the minusMillis() method and this is displayed. A code snippet that demonstrates this is as follows −

Instant i = Instant.now();
System.out.println("The current instant is: " + i);
System.out.println("An instant with 1000 milliseconds subtracted is: " + i.minusMillis(1000));