Returns a copy of this {@code OffsetDateTime} with the specified number of years added.
!(p)
This method adds the specified amount to the years field _in three steps:
!(ol)
!(li)Add the input years to the year field</li>
!(li)Check if the resulting date would be invalid</li>
!(li)Adjust the day-of-month to the last valid day if necessary</li>
</ol>
!(p)
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.
!(p)
This instance is immutable and unaffected by this method call.
@param years the years to add, may be negative
@return an {@code OffsetDateTime} based on this date-time with the years added, not null
@throws DateTimeException if the result exceeds the supported date range
Returns a copy of this {@code OffsetDateTime} with the specified number of years added. !(p) This method adds the specified amount to the years field _in three steps: !(ol) !(li)Add the input years to the year field</li> !(li)Check if the resulting date would be invalid</li> !(li)Adjust the day-of-month to the last valid day if necessary</li> </ol> !(p) 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. !(p) This instance is immutable and unaffected by this method call.
@param years the years to add, may be negative @return an {@code OffsetDateTime} based on this date-time with the years added, not null @throws DateTimeException if the result exceeds the supported date range