YearMonth plus(long,unit) method in Java with Examples

The plus(long, unit) method of YearMonth class used to return a copy of this Year-month after adding the specified amount of TemporalUnit to this Year-month object. An exception is thrown, If the specified unit cannot be added to Year-month. This instance is immutable and unaffected by this method call.

Syntax:

public YearMonth plus(long amountToadd, TemporalUnit unit)

Parameters: This method accepts two parameters:  

• amountToadd: This parameter represents the amount of the unit to add to the result.
• unit This parameter represents the unit of the amount to add.

Return Value: This method returns a Year-month based on this Year-month with the specified amount added.

Exception: This method throws following Exceptions:  

• DateTimeException – This exception is thrown if the addition cannot be made.
• UnsupportedTemporalTypeException – This exception is thrown if the unit is not supported.
• ArithmeticException – This exception is thrown if numeric overflow occurs.

Below programs illustrate the plus(long, unit) method:

Program 1:

Java

// Java program to demonstrate
// YearMonth.plus(long, unit) method

import java.time.*;
import java.time.temporal.*;

public class GFG {
    public static void main(String[] args)
    {
        // Create a YearMonth object
        YearMonth thisYearMonth = YearMonth.of(2017, 8);

        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);

        // apply plus(long, unit) method
        // adding 15 Years
        YearMonth value
            = thisYearMonth.plus(15, ChronoUnit.YEARS);

        // print result
        System.out.println("After addition YearMonth: "
                           + value);
    }
}

Output:

YearMonth :2017-08
After addition YearMonth: 2032-08

Program 2:

Java

// Java program to demonstrate
// YearMonth.plus(long, unit) method

import java.time.*;
import java.time.temporal.*;

public class GFG {
    public static void main(String[] args)
    {
        // Create a YearMonth object
        YearMonth thisYearMonth = YearMonth.of(2019, 12);

        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);

        // apply plus(long, unit) method
        // adding 30 Months
        YearMonth value
            = thisYearMonth.plus(30, ChronoUnit.MONTHS);

        // print result
        System.out.println("After addition YearMonth: "
                           + value);
    }
}

Output:

YearMonth :2019-12
After addition YearMonth: 2022-06

References:
https://docs.oracle.com/javase/10/docs/api/java/time/Year.html#plus(long, java.time.temporal.TemporalUnit)