DateTime.AddYears Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Returns a new DateTime that adds the specified number of years to the value of this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
- Type: System.Int32
The number of years to add. This value can be positive or negative.
Return Value
Type: System.DateTimeAn object whose value is the sum of the date and time represented by this instance and the number of years represented by value.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | value or the resulting DateTime is earlier than DateTime.MinValue or later than DateTime.MaxValue. |
This method does not change the value of this DateTime object. Instead, a new DateTime object is returned whose value is the result of this operation.
The AddYears method calculates the resulting year taking into account leap years. The month and time-of-day part of the resulting DateTime object remains the same as this instance.