Duration minus(Duration) method in Java with Examples

The minus(Duration) 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.

Syntax:

public Duration minus(Duration duration)

Parameters: This method accepts a parameter duration which is the duration to be substracted. It can be positive or negative but not 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.

Below examples illustrate the Duration.minus() method:

Example 1:

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

Output:

PT46H4M

Example 2:

// Java code to illustrate minus() method 
  
import java.time.Duration; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
  
        // Duration 1 using parse() method 
        Duration duration1 
            = Duration.parse("P0DT0H4M"); 
  
        // Duration 2 using ofHours() method 
        Duration duration2 
            = Duration.ofDays(5); 
  
        // Get the duration subtracted 
        // using minus() method 
        System.out.println(duration1 
                               .minus(duration2)); 
    } 
} 

Output:

PT-119H-56M

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

My Personal Notes

Recommended Posts: