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

plus() method of a ChronoZonedDateTime class is used to Returns a copy of this date-time with the specified amount of unit added.If it is not possible to add the amount, because the unit is not supported or for some other reason, an exception is thrown.

Syntax:

default ChronoZonedDateTime plus(long amountToSubtract,
                           TemporalUnit unit)

Parameters: This method accepts two parameters:  

• amountToSubtract: which is the amount of the unit to add to the result, may be negative
• unit: which is the unit of the amount to add.

Return value: This method returns ChronoZonedDateTime based on this date-time with the specified amount added.

Exception: This method throws following Exceptions:  

• DateTimeException: if the addition cannot be made,
• UnsupportedTemporalTypeException: if the unit is not supported.
• ArithmeticException: if numeric overflow occurs.

Below programs illustrate the plus() method:

Program 1:

Java

// Java program to demonstrate
// ChronoZonedDateTime.plus() method

import java.time.*;
import java.time.chrono.*;
import java.time.temporal.ChronoUnit;

public class GFG {
    public static void main(String[] args)
    {

        // create a ChronoZonedDateTime object
        ChronoZonedDateTime zonedlt
            = ZonedDateTime
                  .parse(
                      "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");

        // add 30 Months to ChronoZonedDateTime
        ChronoZonedDateTime value
            = zonedlt.plus(30, ChronoUnit.MONTHS);

        // print result
        System.out.println("ChronoZonedDateTime after"
                           + " adding Months:\n "
                           + value);
    }
}

Output:

ChronoZonedDateTime after adding Months:
 2021-06-06T19:21:12.123+05:30[Asia/Calcutta]

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