-api-id | -api-type |
---|---|
M:Windows.Globalization.Calendar.AddYears(System.Int32) |
winrt method |
Increments or decrements the year.
The number of years by which to increment the year (if the value is positive) or decrement the year (if the value is negative).
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.
Calendar, date, and time controls, Calendar sample, Date and time formatting sample