Skip to content
Related Articles

Related Articles

Duration minus(long, TemporalUnit) method in Java with Examples
  • Last Updated : 26 Nov, 2018

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:




// 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));
    }
}
Output:
PT46H4M

Example 2:




// 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));
    }
}
Output:
PT-47H-56M

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

Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more,  please refer Complete Interview Preparation Course.

My Personal Notes arrow_drop_up
Recommended Articles
Page :