Calendar.AddYears(Int32) Method

Definition

Namespace:

Windows.Globalization

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.

See also

• Calendar, date, and time controls
• Calendar sample
• Date and time formatting sample