Share via

Calendar.AddYears(Int32) Method


Increments or decrements the year.

 virtual void AddYears(int years) = AddYears;
void AddYears(int const& years);
public void AddYears(int years);
function addYears(years)
Public Sub AddYears (years As Integer)




The number of years by which to increment the year (if the value is positive) or decrement the year (if the value is negative).



This API is being updated to support the May 2019 Japanese era change. If your application supports the Japanese calendar, you should validate that it properly handles the new era. See Prepare your application for the Japanese era change for more information.


This API takes leap years into account when calculating the resulting year. The month and time-of-day part of the resulting Calendar object remains the same as this instance. If the current instance represents the leap day (February 29th) in a leap year, date returned will be February 29th of the resulting year only if that year is a leap year, and February 28th of the resulting year otherwise. For more information on leap years in your app, see leap year readiness.

Applies to

See also