java.time.Instant.minus() Method Example

Description

The java.time.Instant.minus(TemporalAmount amountToSubtract) method returns a copy of this instant with the specified amount subtracted.

Declaration

Following is the declaration for java.time.Instant.minus(TemporalAmount amountToSubtract) method.

public Instant minus(TemporalAmount amountToSubtract)

Parameters

amountToSubtract − the amount to subtract, not null.

Return Value

an Instant based on this instant with the specified amount subtracted, not null.

Exceptions

• DateTimeException − if the subtraction cannot be made.

• ArithmeticException − if numeric overflow occurs.

Example

The following example shows the usage of java.time.Instant.minus(TemporalAmount amountToSubtract) method.

package com.tutorialspoint;

import java.time.Instant;
import java.time.Duration;

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

      Instant instant = Instant.parse("2017-02-03T10:37:30.00Z");
      Duration duration = Duration.ofHours(5); 
      Instant result = instant.minus(duration);
      System.out.println(result);  
   }
}

Let us compile and run the above program, this will produce the following result −

2017-02-03T05:37:30Z