This documentation is archived and is not being maintained.

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)

'Declaration
Public Shared Operator - ( _
	d As DateTime, _
	t As TimeSpan _
) As DateTime

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.


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)


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: