DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) Method

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 DateTime DateTime DateTime

Premier objet à comparer.The first object to compare.

t2
DateTime DateTime DateTime DateTime

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

Retours

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

Type valeurValue Type ConditionCondition
Inférieure à 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érieure à zéroGreater than zero t1 est ultérieur à t2.t1 is later than t2.

Exemples

L’exemple suivant illustre la Compare méthode.The following example demonstrates the Compare method.

using System;

public class Example
{
   public static void Main()
   {
      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:
//    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 Compare méthode compare la Ticks propriété de t1 et t2 , mais ignore Kind leur propriété.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 DateTime comparer des objets, 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.

S’applique à

Voir aussi