DateTimeOffset.CompareTo(DateTimeOffset) Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTimeOffset.cs

Vergleicht das aktuelle DateTimeOffset-Objekt mit einem angegebenen DateTimeOffset-Objekt und gibt an, ob das aktuelle Objekt vor oder nach dem zweiten DateTimeOffset-Objekt liegt oder mit diesem identisch ist.

C#

public int CompareTo(DateTimeOffset other);

Parameter

other

DateTimeOffset

Ein Objekt, das mit dem aktuellen DateTimeOffset-Objekt verglichen werden soll.

Gibt zurück

Int32

Eine Ganzzahl mit Vorzeichen, die die Beziehung zwischen dem aktuellen DateTimeOffset-Objekt und other angibt, wie in der folgenden Tabelle gezeigt.

Rückgabewert	BESCHREIBUNG
Kleiner als 0 (null)	Das aktuelle DateTimeOffset-Objekt liegt vor other.
Zero	Das aktuelle DateTimeOffset-Objekt ist mit other identisch.
Größer als 0 (null)	Das aktuelle DateTimeOffset-Objekt liegt nach other.

Implementiert

CompareTo(T)

Beispiele

Das folgende Beispiel veranschaulicht Aufrufe der -Methode zum Vergleichen von CompareToDateTimeOffset Objekten.

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

Hinweise

Diese Methode vergleicht Objekte, indem sie ihre UtcDateTime Werte vergleichtDateTimeOffset. Das heißt, sie bestimmt, ob die beiden Objekte einen einzelnen Zeitpunkt darstellen, und gibt an, ob das aktuelle Objekt früher als, später als oder mit dem other Parameter identisch ist.

Gilt für: