Java Duration plus()

In this guide, you will learn about the Duration plus() method in Java programming and how to use it with an example.

1. Duration plus() Method Overview

Definition:

The Duration.plus() method is used to return a new Duration instance which is the sum of the current duration and the specified duration.

Syntax:

public Duration plus(Duration duration)

Parameters:

- duration: The duration to be added to the current duration. Should be of type Duration.

Key Points:

- The plus() method does not modify the original Duration instance but returns a new instance that represents the sum.

- The method can handle overflows, and if the resulting duration is too large to be represented, an ArithmeticException is thrown.

- Negative durations can be added using this method, which would result in subtracting the absolute value of the duration from the original.

2. Duration plus() Method Example

import java.time.Duration;

public class DurationPlusExample {
    public static void main(String[] args) {
        Duration initialDuration = Duration.ofHours(5);
        Duration additionalDuration = Duration.ofHours(2);

        // Add the durations together
        Duration resultDuration = initialDuration.plus(additionalDuration);

        // Print the resulting duration
        System.out.println("Resulting Duration: " + resultDuration);
    }
}

Output:

Resulting Duration: PT7H

Explanation:

In the provided example, we initially have a duration of 5 hours represented by initialDuration. 

We then have another duration of 2 hours represented by additionalDuration.

Using the plus() method, we add these two durations together, resulting in a new Duration instance of 7 hours. The output, "PT7H", is the standard ISO-8601 representation for a duration of 7 hours.