DateTime.Compare(DateTime, DateTime) Méthode

Définition

Compare deux instances de DateTime et retourne un entier qui indique si la première instance est antérieure, identique ou ultérieure à la deuxième instance.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``

Paramètres

t1
DateTime

Premier objet à comparer.The first object to compare.

t2
DateTime

Deuxième objet à comparer.The second object to compare.

Retours

Int32

Nombre signé indiquant les valeurs relatives de `t1` et de `t2`.A signed number indicating the relative values of `t1` and `t2`.

Type de valeurValue Type ConditionCondition
Inférieur à zéroLess than zero `t1` est antérieur à `t2`.`t1` is earlier than `t2`.
ZéroZero `t1` est identique à `t2`.`t1` is the same as `t2`.
Supérieur à zéroGreater than zero `t1` est ultérieur à `t2`.`t1` is later than `t2`.

Exemples

L’exemple suivant illustre la méthode Compare.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
``````

Remarques

Pour déterminer la relation de `t1` à `t2`, la méthode Compare compare la propriété Ticks de `t1` et `t2`, mais ignore leur propriété Kind.To determine the relationship of `t1` to `t2`, the Compare method compares the Ticks property of `t1` and `t2` but ignores their Kind property. Avant de comparer des objets DateTime, assurez-vous que les objets représentent des heures dans le même fuseau horaire.Before comparing DateTime objects, ensure that the objects represent times in the same time zone.