Export (0) Print
Expand All

DateTime Subtraction Operator (DateTime, TimeSpan)

.NET Framework 1.1

Subtracts a specified time interval from a specified date and time, yielding a new date and time.

[Visual Basic]
returnValue = DateTime.op_Subtraction(d, t)
[C#]
public static DateTime operator -(
 DateTime d,
 TimeSpan t
);
[C++]
public: static DateTime op_Subtraction(
 DateTime d,
 TimeSpan t
);
[JScript]
returnValue = d - t;

[Visual Basic] In Visual Basic, you can use the operators defined by a type, but you cannot define your own. You can use the Subtract method instead of the DateTime subtraction operator.

[JScript] In JScript, you can use the operators defined by a type, but you cannot define your own.

Arguments [Visual Basic, JScript]

d
A DateTime.
t
A TimeSpan.

Parameters [C#, C++]

d
A DateTime.
t
A TimeSpan.

Return Value

A DateTime whose value is the value of d minus the value of t.

Remarks

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

Example

[Visual Basic, C#, C++] The following sample demonstrates the Subtract method and operator.

[Visual Basic] 
Dim date1 As New System.DateTime(1996, 6, 3, 22, 15, 0)
Dim date2 As New System.DateTime(1996, 12, 6, 13, 2, 0)
Dim date3 As New System.DateTime(1996, 10, 12, 8, 42, 0)

Dim diff1 As System.TimeSpan
' diff1 gets 185 days, 14 hours, and 47 minutes.
diff1 = date2.Subtract(date1)

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

Dim diff2 As System.TimeSpan
' diff2 gets 55 days 4 hours and 20 minutes.
diff2 = System.DateTime.op_Subtraction(date2, date3)

Dim date5 As System.DateTime
' date5 gets 4/9/1996 5:55:00 PM.
date5 = System.DateTime.op_Subtraction(date1, diff2)

[C#] 
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;

[C++] 
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;

[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 | DateTime Subtraction Operator Overload List | Ticks | TimeSpan

Show:
© 2014 Microsoft