Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DateTime.AddDays Method

Adds the specified number of days to the value of this instance.

[Visual Basic]
Public Function AddDays( _
   ByVal value As Double _
) As DateTime
[C#]
public DateTime AddDays(
 double value
);
[C++]
public: DateTime AddDays(
 double value
);
[JScript]
public function AddDays(
   value : double
) : DateTime;

Parameters

value
A number of whole and fractional days. The value parameter can be negative or positive.

Return Value

A DateTime whose value is the sum of the date and time represented by this instance and the number of days represented by value.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException The resulting DateTime is less than MinValue or greater than 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 tick.

Example

[Visual Basic, C#, C++] The following sample demonstrates the AddDays method.

[Visual Basic] 
' 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)

System.Console.WriteLine("{0:dddd}", answer)

[C#] 
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.DateTime answer = today.AddDays(36);
System.Console.WriteLine("{0:dddd}", answer);

[C++] 
// Calculate what day of the week is 36 days from this instant.
System::DateTime today = System::DateTime::Now;
System::DateTime answer = today.AddDays(36);
System::Console::WriteLine(S"{0:dddd}", __box(answer));

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

DateTime Structure | DateTime Members | System Namespace | Double

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.