LocalDate plusYears() method in Java with Examples

Last Updated : 30 Jul, 2019

The plusYears() method of LocalDate class in Java is used to add the number of specified years in this LocalDate and return a copy of LocalDate. This method adds the years field in the following steps:

Add the years to the year field.
Check if the date after adding years is valid or not.
If date is invalid then method adjust the day-of-month to the last valid day.

For example, 2016-02-29 (leap year) plus one year gives date 2017-02-29 but this is invalid result, so the last valid day of the month, 2017-02-28, is returned.This instance is immutable and unaffected by this method call. Syntax:

public LocalDate plusYears(long yearsToAdd)

Parameters: This method accepts a single parameter yearsToAdd which represents the years to add, may be negative. Return value: This method returns a LocalDate based on this date with the years added, not null. Exception: This method throws DateTimeException if the result exceeds the supported date range. Below programs illustrate the plusYears() method: Program 1:

Java

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

import java.time.*;

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

        // create a LocalDate object
        LocalDate date
            = LocalDate.parse("2018-11-13");

        // print instance
        System.out.println("LocalDate before"
                           + " adding years: " + date);

        // add 3 years
        LocalDate returnvalue
            = date.plusYears(3);

        // print result
        System.out.println("LocalDate after "
                           + " adding years: " + returnvalue);
    }
}

Output:

LocalDate before adding years: 2018-11-13
LocalDate after  adding years: 2021-11-13

Program 2:

Java

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

import java.time.*;

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

        // create a LocalDate object
        LocalDate date
            = LocalDate.parse("2016-02-29");

        // print instance
        System.out.println("LocalDate before"
                           + " adding years: " + date);

        // add 2 years
        LocalDate returnvalue
            = date.plusYears(2);

        // print result
        System.out.println("LocalDate after "
                           + " adding years: " + returnvalue);
    }
}

Output:

LocalDate before adding years: 2016-02-29
LocalDate after  adding years: 2018-02-28

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

LocalDate minusYears() method in Java with Examples

AmanSingh2210

Improve

Article Tags :

Practice Tags :

Java

LocalDate plusYears() method in Java with Examples

Similar Reads

Thank You!

What kind of Experience do you want to share?