Export (0) Print
Expand All

DateTime.Compare Method

Compares two instances of DateTime and returns an integer that indicates whether the first instance is earlier than, the same as, or later than the second instance.

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

'Declaration
Public Shared Function Compare ( _
	t1 As DateTime, _
	t2 As DateTime _
) As Integer

Parameters

t1
Type: System.DateTime

The first object to compare.

t2
Type: System.DateTime

The second object to compare.

Return Value

Type: System.Int32
A signed number indicating the relative values of t1 and t2.

Value Type

Condition

Less than zero

t1 is earlier than t2.

Zero

t1 is the same as t2.

Greater than zero

t1 is later than t2.

Before comparing DateTime objects, ensure that the objects represent times in the same time zone.

The following example demonstrates the Compare method.

Module Example
   Public Sub Main()
      Dim date1 As Date = #08/01/2009 12:00AM#
      Dim date2 As Date = #08/01/2009 12:00PM#
      Dim result As Integer = DateTime.Compare(date1, date2)
      Dim relationship As String 

      If result < 0 Then
         relationship = "is earlier than" 
      ElseIf result = 0 Then
         relationship = "is the same time as"          
      Else
         relationship = "is later than" 
      End If

      Console.WriteLine("{0} {1} {2}", date1, relationship, date2)
   End Sub 
End Module 
' The example displays the following output: 
'    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM

.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