Java Instant minus() method

The minus() method of Java Instant class is used to return a copy of this instant with the specified amount subtracted.

The Instant minus() method consists of 2 type of parameters:

Java Instant minus(TemporalAmount amountToSubtract) method
Java Instant minus(long amountToSubtract, TemporalUnit unit)

The minus(TemporalAmount amountToSubtract) method returns an Instant, based on this one, with the specified amount subtracted. The amount is typically Duration but may be any other type implementing the TemporalAmount interface.

The minus(long amountToSubtract, TemporalUnit unit) returns an Instant, based on this one, with the amount in terms of the unit subtracted. If it is not possible to subtract the amount, because the unit is not supported or for some other reason, an exception is thrown.

Syntax

public Instant minus(TemporalAmount amountToSubtract)
public Instant minus(long amountToSubtract, TemporalUnit unit)

Parameters

amountToSubtract - the amount to subtract, not null

amountToSubtract - the amount of the unit to subtract from the result, may be negative.

unit - the unit of the amount to subtract, not null.

Return

An Instant based on this instant with the subtraction made, not null

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

DateTimeException - if the subtraction cannot be made

UnsupportedTemporalTypeException - if the unit is not supported

ArithmeticException - if numeric overflow occurs

Example 1

import java.time.Instant;
import java.time.temporal.ChronoUnit;
public class InstantMinusExample1 {
   public static void main(String[] args) {
      Instant instant = Instant.parse("2017-02-03T10:37:30.00Z");
      Instant result = instant.minus(10, ChronoUnit.MINUTES);
      System.out.println(result);  
   }
}

Output:

The output will be like this.

2017-02-03T10:27:30Z

Example 2

import java.time.Instant;
import java.time.temporal.ChronoUnit;
public class InstantMinusExample2 {
  public static void main(String[] args) {
    Instant instant = Instant.parse("2014-12-03T10:15:30.00Z");
    instant = instant.minus(100,ChronoUnit.DAYS);
    System.out.println(instant);
 
  }
}

Output:

The output will be like this.

2014-08-25T10:15:30Z

Example 3

import java.time.Instant;
import java.time.temporal.ChronoUnit;
public class InstantMinusExample3 {
  public static void main(String[] args) {
    Instant instant = Instant.parse("2014-12-03T10:15:30.00Z");
    instant = instant.minus(100,ChronoUnit.HOURS);
    System.out.println(instant);
 
  }
}

Output:

The output will be like this.

2014-12-03T10:15:30Z

Example 4

import java.time.Instant;
import java.time.temporal.ChronoUnit;
public class InstantMinusExample4 {
  public static void main(String[] args) {
    Instant instant = Instant.parse("2014-12-03T10:15:30.00Z");
    instant = instant.minus(100,ChronoUnit.SECONDS);
    System.out.println(instant);
 
  }
}

Output:

The output will be like this.

2014-12-03T10:15:33Z

Example 5

import java.time.Instant;
import java.time.temporal.ChronoUnit;
import java.time.temporal.UnsupportedTemporalTypeException;
public class InstantMinusExample5 {
    public static void main(String... args) {
        Instant i = Instant.now();
        System.out.println(i);
        for (ChronoUnit unit : ChronoUnit.values()) {
            try {
                Instant v = i.minus(10, unit);
                System.out.printf("%8s > %s%n", unit, v);
            } catch (UnsupportedTemporalTypeException e) {
                System.out.printf("      -- %s not supported%n", unit);
          }
      }
   }
}

Output:

The output will be like this.

2017-05-01T20:57:43.045Z

   Nanos > 2017-05-01T20:57:43.044999990Z

  Micros > 2017-05-01T20:57:43.044990Z

  Millis > 2017-05-01T20:57:43.035Z

 Seconds > 2017-05-01T20:57:33.045Z

 Minutes > 2017-05-01T20:47:43.045Z

   Hours > 2017-05-01T10:57:43.045Z

HalfDays > 2017-04-26T20:57:43.045Z

    Days > 2017-04-21T20:57:43.045Z

      -- Weeks not supported

      -- Months not supported

      -- Years not supported

      -- Decades not supported

      -- Centuries not supported

      -- Millennia not supported

      -- Eras not supported

      -- Forever not supported

Examples Java Instant minus(long amountToSubtract, TemporalUnit unit) Method

Example 6

import java.time.Duration;
import java.time.Instant;
public class InstantMinusExample6 {
  public static void main(String[] args) {
    Instant instant = Instant.parse("2014-12-03T10:15:30.00Z");
    instant = instant.minus(Duration.ofDays(100));
    System.out.println(instant);
 
  }
}

Output:

The output will be like this.

2014-08-25T10:15:30Z

Example 7

import java.time.Instant;
import java.time.Duration;
public class InstantMinusExample7 {
   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);  
   }
}

Output:

The output will be like this.