DateTime.AddDays 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 days to the value of this instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
Public Function AddDays ( _
value As Double _
) As DateTime
public DateTime AddDays(
double value
)
Parameters
- value
Type: System..::.Double
The number of whole and fractional days 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 days represented by value.
Exceptions
Exception | Condition |
---|---|
ArgumentOutOfRangeException | The resulting DateTime is earlier than DateTime..::.MinValue or later than DateTime..::.MaxValue. |
Remarks
This method does not change the value of this DateTime. Instead, a new DateTime is returned whose value is the result of this operation.
The fractional part of value is the fractional part of a day. For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds, and 0 ticks.
The value parameter is rounded to the nearest millisecond.
Examples
The following example demonstrates the AddDays method.
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim answer As System.DateTime
today = System.DateTime.Now
answer = today.AddDays(36)
outputBlock.Text += String.Format("{0:dddd}", answer) + vbCrLf
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.DateTime answer = today.AddDays(36);
outputBlock.Text += String.Format("{0:dddd}", answer) + "\n";
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone