public LocalDate minusYears (long yearsToSubtract)

Returns a copy of this LocalDate with the specified number of years subtracted.

This method subtracts the specified amount from the years field in three steps:

1. Subtract the input years from the year field
2. Check if the resulting date would be invalid
3. Adjust the day-of-month to the last valid day if necessary

For example, 2008-02-29 (leap year) minus one year would result in the invalid date 2007-02-29 (standard year). Instead of returning an invalid result, the last valid day of the month, 2007-02-28, is selected instead.

This instance is immutable and unaffected by this method call.

Parameters:

yearsToSubtract

the years to subtract, may be negative

Returns:  a LocalDate based on this date with the years subtracted, not null

Exceptions:

DateTimeException

if the result exceeds the supported date range