System Namespace   DateTime Structure

---

Subtracts the specified duration from this instance.

[ VB ]
<Serializable>
Overloads Public Function Subtract ( _
   ByVal value As TimeSpan _
) As DateTime

[ C# ]
[ Serializable ]
public DateTime Subtract (
   TimeSpan value
);

[ C++ ]
[ Serializable ]
public: DateTime Subtract (
   TimeSpan value
);

[ JScript ]
public Serializable
function Subtract (
   value : TimeSpan
) : DateTime;

value

An instance of TimeSpan.

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

Exception Type	Condition
ArgumentOutOfRangeException	The result 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 below code snippet demonstrates using the Subtract method and operator.

[ VB ]
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;

DateTime Members   DateTime.Subtract Overload List   TimeSpan

Suggested Reading