DateTimeOffset::AddYears Method (Int32)
Returns a new DateTimeOffset object that adds a specified number of years to the value of this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- years
-
Type:
System::Int32
A number of years. The number can be negative or positive.
Return Value
Type: System::DateTimeOffsetAn object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of years represented by years.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The resulting DateTimeOffset value is less than MinValue. -or- The resulting DateTimeOffset value is greater than MaxValue. |
Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, AddYears does not enable you to add fractional parts of a year. To add a time that consists of other time units in addition to years to a DateTimeOffset object, use the Add method.
Note |
|---|
This method returns a new DateTimeOffset object. It does not modify the value of the current object by adding months to its date and time. |
In the United States, driver's licenses cannot be issued to persons under 16 years of age. The following example displays the latest possible date on which a person must be born in order to legally be issued a driver's license.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
