Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

DateTime::Subtraction Operator (DateTime, TimeSpan)

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.

ExceptionCondition
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 = System::DateTime( 1996, 6, 3, 22, 15, 0 );
System::DateTime date2 = System::DateTime( 1996, 12, 6, 13, 2, 0 );
System::DateTime date3 = 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;

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft