DateTime.Compare Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Compares two instances of DateTime and returns an integer that indicates whether the first DateTime instance is earlier than, the same as, or later than the second DateTime instance.
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.Int32A 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.
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 outputBlock.Text += String.Format("{0} {1} {2}", date1, relationship, date2) + Environment.NewLine ' The example displays the following output: ' 8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM