DateTime.Compare(DateTime, DateTime) Methode

Definition

Vergleicht zwei Instanzen von DateTime und gibt eine ganze Zahl zurück, die angibt, ob die erste Instanz früher oder später als die zweite Instanz ist oder ob sie mit dieser identisch ist.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.

public:
 static int Compare(DateTime t1, DateTime t2);
public static int Compare (DateTime t1, DateTime t2);
static member Compare : DateTime * DateTime -> int
Public Shared Function Compare (t1 As DateTime, t2 As DateTime) As Integer

Parameter

t1
DateTime

Das erste zu vergleichende Objekt.The first object to compare.

t2
DateTime

Das zweite zu vergleichende Objekt.The second object to compare.

Gibt zurück

Eine Zahl mit Vorzeichen, die die relativen Werte von t1 und t2 angibt.A signed number indicating the relative values of t1 and t2.

WerttypValue Type BedingungCondition
Kleiner als 0 (null)Less than zero t1 liegt vor t2.t1 is earlier than t2.
ZeroZero t1 entspricht t2.t1 is the same as t2.
Größer als 0 (null)Greater than zero t1 ist später als t2.t1 is later than t2.

Beispiele

Das folgende Beispiel veranschaulicht die Compare Methode.The following example demonstrates the Compare method.

DateTime date1 = new DateTime(2009, 8, 1, 0, 0, 0);
DateTime date2 = new DateTime(2009, 8, 1, 12, 0, 0);
int result = DateTime.Compare(date1, date2);
string relationship;

if (result < 0)
   relationship = "is earlier than";
else if (result == 0)
   relationship = "is the same time as";         
else
   relationship = "is later than";

Console.WriteLine("{0} {1} {2}", date1, relationship, date2);

// The example displays the following output for en-us culture:
//    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM
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

Hinweise

Zum Ermitteln der Beziehung zwischen t1 und t2 vergleicht die Compare-Methode die Ticks-Eigenschaft von t1 und t2, ignoriert aber deren Kind-Eigenschaft.To determine the relationship of t1 to t2, the Compare method compares the Ticks property of t1 and t2 but ignores their Kind property. Vor dem Vergleichen von DateTime-Objekten müssen Sie sicherstellen, dass die-Objekte Zeiten in derselben Zeitzone darstellen.Before comparing DateTime objects, ensure that the objects represent times in the same time zone.

Gilt für:

Siehe auch