Duration minus(long, TemporalUnit) method in Java with Examples

The minus(long, TemporalUnit) method of Duration Class in java.time package is used to get an immutable copy of this duration with the specified duration substracted, passed as the parameter. The duration to be substracted is decided by converting the amountToAdd in the unit passed as the parameters.

Syntax:

public Duration minus(long amountToAdd, TemporalUnit unit)

Parameters: This method accepts two parameters:



  • amountToAdd which is the amount to be substracted. It can be positive or negative but not null.
  • unit which is the TemporalUnit of the amount to be substracted. It cannot be null.

Return Value: This method returns a Duration which is an immutable copy of the existing duration with the parameter amount of duration substracted to it.

Exception: This method throws:

  • ArithmeticException: if numeric overflow occurs.
  • UnsupportedTemporalTypeException: if the unit is not supported.

Below examples illustrate the Duration.minus() method:

Example 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java code to illustrate minus() method
  
import java.time.Duration;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Duration 1 using parse() method
        Duration duration1
            = Duration.parse("P2DT3H4M");
  
        // Get the duration substracted
        // using minus() method
        System.out.println(duration1
                               .minus(5,
                                      ChronoUnit.HOURS));
    }
}

chevron_right


Output:

PT46H4M

Example 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java code to illustrate minus() method
  
import java.time.Duration;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Duration 1 using parse() method
        Duration duration1
            = Duration.parse("P0DT0H4M");
  
        // Get the duration substracted
        // using minus() method
        System.out.println(duration1
                               .minus(2,
                                      ChronoUnit.DAYS));
    }
}

chevron_right


Output:

PT-47H-56M

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



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.