DateTime.Subtraction Operator (DateTime, TimeSpan)

 
equivalentCodeEntityM:System.DateTime.Subtract(System.DateTime)

Subtracts a specified time interval from a specified date and time and returns a new date and time.

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

public static DateTime operator -(
	DateTime d,
	TimeSpan t
)

Parameters

d
Type: System.DateTime

The date and time value to subtract from.

t
Type: System.TimeSpan

The time interval to subtract.

Return Value

Type: System.DateTime

An object whose value is the value of d minus the value of t.

Exception Condition
ArgumentOutOfRangeException

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

This method subtracts the ticks value of t from the ticks value of d.

The following example demonstrates the Subtract method and the subtraction 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;

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
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
Return to top
Show: