DateTimeOffset.CompareTo(DateTimeOffset) Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTimeOffset.cs

Compare l'objet DateTimeOffset en cours à un objet DateTimeOffset spécifié et indique si l'objet en cours est antérieur, égal ou ultérieur au second objet DateTimeOffset.

C#

public int CompareTo(DateTimeOffset other);

Paramètres

other

DateTimeOffset

Objet à comparer à l’objet DateTimeOffset actuel.

Retours

Int32

Entier signé indiquant la relation entre l'objet DateTimeOffset en cours et other, comme l'indique le tableau suivant.

Valeur de retour	Description
Inférieure à zéro	L'objet DateTimeOffset en cours est antérieur à other.
Zéro	L'objet DateTimeOffset en cours est identique à other.
Supérieure à zéro.	L'objet DateTimeOffset en cours est ultérieur à other.

Implémente

CompareTo(T)

Exemples

L’exemple suivant illustre les appels à la CompareTo méthode pour comparer des DateTimeOffset objets.

C#

using System;

public class CompareTimes
{
   private enum TimeComparison
   {
      Earlier = -1,
      Same = 0,
      Later = 1
   };

   public static void Main()
   {
      DateTimeOffset firstTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                                 new TimeSpan(-7, 0, 0));

      DateTimeOffset secondTime = firstTime;
      Console.WriteLine("Comparing {0} and {1}: {2}",
                        firstTime, secondTime,
                        (TimeComparison) firstTime.CompareTo(secondTime));

      secondTime = new DateTimeOffset(2007, 9, 1, 6, 45, 0,
                       new TimeSpan(-6, 0, 0));
      Console.WriteLine("Comparing {0} and {1}: {2}",
                       firstTime, secondTime,
                       (TimeComparison) firstTime.CompareTo(secondTime));

      secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0,
                       new TimeSpan(-5, 0, 0));
      Console.WriteLine("Comparing {0} and {1}: {2}",
                       firstTime, secondTime,
                       (TimeComparison) firstTime.CompareTo(secondTime));
      // The example displays the following output to the console:
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 6:45:00 AM -07:00: Same
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 6:45:00 AM -06:00: Later
      //       Comparing 9/1/2007 6:45:00 AM -07:00 and 9/1/2007 8:45:00 AM -05:00: Same
   }
}

Remarques

Cette méthode compare les DateTimeOffset objets en comparant leurs UtcDateTime valeurs, c’est-à-dire qu’elle détermine si les deux objets représentent un point unique dans le temps et indique si l’objet actuel est antérieur, postérieur à ou identique au other paramètre .

S’applique à