This documentation is archived and is not being maintained.

DateTime.Subtract Method (DateTime)

Subtracts the specified date and time from this instance.

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

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

Parameters

value

An instance of DateTime.

Return Value

A TimeSpan interval equal to the date and time represented by this instance minus the date and time represented by value.

Exception typeCondition

ArgumentOutOfRangeException

The result is less than MinValue or greater than MaxValue.

This method does not change the value of this DateTime object. Instead, a new TimeSpan is returned whose value is the result of this operation.

Before subtracting DateTime objects, insure that the objects represent times in the same time zone. Otherwise, the result will include the difference between time zones.

The following code example demonstrates the Subtract method and operator.

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);

// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);

// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);

// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2 - date3;

// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1 - diff2;

System.DateTime date1 = new System.DateTime(1996, 6, 3, 22, 15, 0);
System.DateTime date2 = new System.DateTime(1996, 12, 6, 13, 2, 0);
System.DateTime date3 = new System.DateTime(1996, 10, 12, 8, 42, 0);
// diff1 gets 185 days, 14 hours, and 47 minutes.
System.TimeSpan diff1 = date2.Subtract(date1);
// date4 gets 4/9/1996 5:55:00 PM.
System.DateTime date4 = date3.Subtract(diff1);
// diff2 gets 55 days 4 hours and 20 minutes.
System.TimeSpan diff2 = date2.Subtract(date3);
// date5 gets 4/9/1996 5:55:00 PM.
System.DateTime date5 = date1.Subtract(diff2);

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
Show: