DateTime.AddYears Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Returns a new DateTime that adds the specified number of years to the value of this instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Function AddYears ( _
value As Integer _
) As DateTime
public DateTime AddYears(
int value
)
Parameters
- value
Type: System.Int32
The number of years to add. This value can be positive or negative.
Return Value
Type: System.DateTime
An object whose value is the sum of the date and time represented by this instance and the number of years represented by value.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | value or the resulting DateTime is earlier than DateTime.MinValue or later than DateTime.MaxValue. |
Remarks
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.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.