DateTimeOffset.CompareTo(DateTimeOffset) DateTimeOffset.CompareTo(DateTimeOffset) DateTimeOffset.CompareTo(DateTimeOffset) DateTimeOffset.CompareTo(DateTimeOffset) Method

Definition

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.Compares the current DateTimeOffset object to a specified DateTimeOffset object and indicates whether the current object is earlier than, the same as, or later than the second DateTimeOffset object.

public:
 virtual int CompareTo(DateTimeOffset other);
public int CompareTo (DateTimeOffset other);
abstract member CompareTo : DateTimeOffset -> int
override this.CompareTo : DateTimeOffset -> int
Public Function CompareTo (other As DateTimeOffset) As Integer

Parameter

other
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Ein Objekt, das mit dem aktuellen DateTimeOffset-Objekt verglichen werden soll.An object to compare with the current DateTimeOffset object.

Gibt zurück

Eine ganze Zahl mit Vorzeichen, die die Beziehung zwischen dem aktuellen DateTimeOffset-Objekt und other angibt, wie in der folgenden Tabelle gezeigt.A signed integer that indicates the relationship between the current DateTimeOffset object and other, as the following table shows.

RückgabewertReturn Value BESCHREIBUNGDescription
Kleiner als 0Less than zero Das aktuelle DateTimeOffset-Objekt liegt vor other.The current DateTimeOffset object is earlier than other.
ZeroZero Das aktuelle DateTimeOffset-Objekt ist mit other identisch.The current DateTimeOffset object is the same as other.
Größer als 0 (null)Greater than zero. Das aktuelle DateTimeOffset-Objekt liegt nach other.The current DateTimeOffset object is later than other.

Implementiert

Beispiele

Das folgende Beispiel veranschaulicht Aufrufe der CompareTo -Methode, um-Objekte zu vergleichen. DateTimeOffsetThe following example illustrates calls to the CompareTo method to compare DateTimeOffset objects.

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         
   }
}
Module CompareTimes
   Private Enum TimeComparison As Integer
      Earlier = -1
      Same = 0
      Later = 1
   End Enum
      
   Public Sub Main()
      Dim firstTime As New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                       New TimeSpan(-7, 0, 0))
  
      Dim secondTime As DateTimeOffset = firstTime
      Console.WriteLine("Comparing {0} and {1}: {2}", _
                        firstTime, secondTime, _
                        CType(firstTime.CompareTo(secondTime), _
                              TimeComparison))

      secondTime = New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                       New TimeSpan(-6, 0, 0))      
      Console.WriteLine("Comparing {0} and {1}: {2}", _
                       firstTime, secondTime, _
                       CType(firstTime.CompareTo(secondTime), _
                             TimeComparison))
      
      secondTime = New DateTimeOffset(#09/01/2007 8:45:00AM#, _
                       New TimeSpan(-5, 0, 0))
      Console.WriteLine("Comparing {0} and {1}: {2}", _
                       firstTime, secondTime, _
                       CType(firstTime.CompareTo(secondTime), _
                             TimeComparison))
      ' 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      
   End Sub
End Module

Hinweise

Diese Methode vergleicht DateTimeOffset Objekte durch Vergleichen Ihrer UtcDateTime Werte. das heißt, Sie bestimmt, ob die beiden-Objekte einen einzelnen Zeitpunkt darstellen, und gibt an, ob das aktuelle Objekt vor oder othernachdem-Parameter.This method compares DateTimeOffset objects by comparing their UtcDateTime values; that is, it determines whether the two objects represent a single point in time, and indicates whether the current object is earlier than, later than, or the same as the other parameter.

Gilt für: