Returns a copy of this LocalDate with the specified number of years added.
This method adds the specified amount to the years field in three steps:
For example, 2008-02-29 (leap year) plus one year would result in the invalid date 2009-02-29 (standard year). Instead of returning an invalid result, the last valid day of the month, 2009-02-28, is selected instead.
This instance is immutable and unaffected by this method call.
yearsToAdd | the years to add, may be negative |
LocalDate based on this date with the years added, not null
DateTimeException | if the result exceeds the supported date range |
Diagram: LocalDate