Thursday, February 5, 2026
HomeLanguagesJavaDuration minus(Duration) method in Java with Examples

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 subtracted, passed as the parameter.
Syntax: 
 

public Duration minus(Duration duration)

Parameters: This method accepts a parameter duration which is the duration to be subtracted. 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 subtracted to it.
Exception: This method throws ArithmeticException if numeric overflow occurs.
Below examples illustrate the Duration.minus() method:
Example 1:
 

Java




// 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




// 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-
 

RELATED ARTICLES

Most Popular

Dominic
32481 POSTS0 COMMENTS
Milvus
126 POSTS0 COMMENTS
Nango Kala
6857 POSTS0 COMMENTS
Nicole Veronica
11982 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12069 POSTS0 COMMENTS
Shaida Kate Naidoo
6992 POSTS0 COMMENTS
Ted Musemwa
7230 POSTS0 COMMENTS
Thapelo Manthata
6940 POSTS0 COMMENTS
Umr Jansen
6923 POSTS0 COMMENTS