Export (0) Print
Expand All
Expand Minimize

DateTime.Add Method

Adds the value of the specified TimeSpan to the value of this instance.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public DateTime Add (
	TimeSpan value
)
public DateTime Add (
	TimeSpan value
)
public function Add (
	value : TimeSpan
) : DateTime

Parameters

value

A TimeSpan that contains the interval to add.

Return Value

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

Exception typeCondition

ArgumentOutOfRangeException

The resulting DateTime is less than MinValue or greater than MaxValue.

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 following code example demonstrates the Add method. It calculates the day of the week that is 36 days (864 hours) from this moment.

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.get_Now();
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft