Duration plus(long, TemporalUnit) method in Java with Examples

The plus(long, TemporalUnit) method of Duration Class in java.time package is used to get an immutable copy of this duration with the specified duration added, passed as the parameter. The duration to be added is decided by converting the amountToAdd in the unit passed as the parameters.

Syntax:

public Duration
    plus(long amountToAdd, TemporalUnit unit)

Parameters: This method accepts two parameters:

• amountToAdd which is the amount to be added. It can be positive or negative but not null.
• unit which is the TemporalUnit of the amount to be added. 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 added to it.

Exception: This method throws:

• ArithmeticException: if numeric overflow occurs.
• UnsupportedTemporalTypeException: if the unit is not supported.

Below examples illustrate the Duration.plus() method:

Example 1:

// Java code to illustrate plus() 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 added
        // using plus() method
        System.out.println(
            duration1
                .plus(5, ChronoUnit.HOURS));
    }
}

Output:

PT56H4M

Example 2:

// Java code to illustrate plus() 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 added
        // using plus() method
        System.out.println(
            duration1
                .plus(2, ChronoUnit.DAYS));
    }
}

Output:

PT48H4M

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