DateTimeOffset::AddDays Method (Double)
Returns a new DateTimeOffset object that adds a specified number of whole and fractional days to the value of this instance.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- days
-
Type:
System::Double
A number of whole and fractional days. 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 days represented by days.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The resulting DateTimeOffset value is less than MinValue. -or- The resulting DateTimeOffset value is greater than MaxValue. |
The fractional part of the days parameter is the fractional part of a day. For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds. The days parameter is rounded to the nearest millisecond.
Note |
|---|
This method returns a new DateTimeOffset object. It does not modify the value of the current object by adding days to its date and time. |
Because a DateTimeOffset object does not represent the date and time in a specific time zone, the AddDays method does not consider a particular time zone's adjustment rules when it performs date and time arithmetic.
Converting time intervals of less than a day to a fraction can involve a loss of precision. If this is problematic, you can use the Add method, which enables you to specify more than one kind of time interval in a single method call and eliminates the need to convert time intervals to fractional parts of a day.
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
