Calendar.AddYears(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Increments or decrements the year.
public:
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)Parameters
- years
-
Int32
int
The number of years by which to increment the year (if the value is positive) or decrement the year (if the value is negative).
Remarks
Note
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.
Note
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.