YearMonth plusYears() method in Java with Examples

The plusYears() method of YearMonth class in Java is used to return a copy of this YearMonth with the specified number of years added. Syntax:

public YearMonth plusYears(long yearsToAdd)

Parameter: This method accepts yearsToAdd as parameters which represents years to add to current YearMonth object. It may be negative. Return Value: It returns a YearMonth based on this year-month with the years added. Exceptions: This method throws DateTimeException if the result exceeds the supported range. Below programs illustrate the plusYears() method of YearMonth in Java: Program 1:

Java

// Java program to demonstrate
// YearMonth.plusYears() method

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

public class GFG {
    public static void main(String[] args)
    {
        // Create YearMonth object
        YearMonth yearmonth
            = YearMonth.parse("2020-05");

        // Apply plusYears() method
        // of YearMonth class
        YearMonth result
            = yearmonth.plusYears(5);
        // It will add 5 years into May 2020
        // So it will be May 2025

        // print results
        System.out.println(
            "Modified YearMonth: "
            + result);
    }
}

Output:

Modified YearMonth: 2025-05

Program 2:

Java

// Java program to demonstrate
// YearMonth.plusYears() method

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

public class GFG {
    public static void main(String[] args)
    {
        // Create YearMonth object
        YearMonth yearmonth
            = YearMonth.of(2019, 10);
        // It is October 2019

        // apply plusYears() method
        // of YearMonth class
        YearMonth result
            = yearmonth.plusYears(10);
        // YearMonth will become October 2029

        // print only modified year
        System.out.println(
            "Modified Year: "
            + result.get(ChronoField.YEAR));
    }
}

Output:

Modified Year: 2029

References: https://docs.oracle.com/javase/10/docs/api/java/time/YearMonth.html#plusYears(long)

YearMonth plusYears() method in Java with Examples

Explore