Home » Java » Java Reference » Java Duration Class

Java Duration Class | minusHours() Method with Example

Duration Class minusHours() method: Here, we are going to learn about the minusHours() method of Duration Class with its syntax and example.
Submitted by Preeti Jain, on May 16, 2020

Duration Class minusHours() method

• minusHours() method is available in java.time package.
• minusHours() method is used to subtract the given duration in hours from this Duration.
• minusHours() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• minusHours() method may throw an exception at the time of performing subtraction.
  ArithmeticException: This exception may throw when the calculated result value exceeds the limit.

Syntax:

    public Duration minusHours(long hrs_val);

Parameter(s):

• long hrs_val – represents the hours to be subtracted from this Duration.

Return value:

The return type of this method is Duration, it returns the Duration that holds the value subtracted the given hours from this Duration.

Example:

// Java program to demonstrate the example 
// of minusHours(long hrs_val) method of Duration

import java.time.*;

public class MinusHoursOfDuration {
    public static void main(String args[]) {
        long hours = 5;

        // Instantiates two Duration objects
        Duration du1 = Duration.ofHours(6);
        Duration du2 = Duration.parse("P2DT2H20M");

        // Display du1, du2 
        System.out.println("du1: " + du1);
        System.out.println("du2: " + du2);

        System.out.println();

        // subtracts the given duration
        // in hours from this Duration du1 and returns
        // the Duration i.e. here we are substracting
        // the given 5 hours from this du1 that holds
        // the value of 6 hours
        Duration minus_val = du1.minusHours(hours);

        // Display minus_val
        System.out.println("du1.minusHours(hours): " + minus_val);

        // subtracts the given duration
        // in hours from this Duration du2 and returns
        // the Duration i.e. here we are substracting
        // the given 5 hours from this du2 that holds
        // the value of 50 hours : 20 minutes
        minus_val = du2.minusHours(hours);

        // Display minus_val
        System.out.println("du2.minusHours(hours): " + minus_val);
    }
}

Output

du1: PT72H
du2: PT48H20M

du1.minusDays(days): PT24H
du2.minusDays(days): PT20M