DateTimeOffset.Equals Methode

Definition

Bestimmt, ob zwei DateTimeOffset-Objekte identisch sind oder ob ein DateTimeOffset-Objekt mit einem angegebenen Objekt identisch ist.Determines whether two DateTimeOffset objects are equal, or a DateTimeOffset object is equal to a specified object.

Überlädt

Equals(DateTimeOffset)

Bestimmt, ob das aktuelle DateTimeOffset-Objekt denselben Zeitpunkt wie ein angegebenes DateTimeOffset-Objekt darstellt.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object)

Bestimmt, ob ein DateTimeOffset-Objekt denselben Zeitpunkt wie ein angegebenes Objekt darstellt.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset)

Bestimmt, ob zwei angegebene DateTimeOffset-Objekte denselben Zeitpunkt darstellen.Determines whether two specified DateTimeOffset objects represent the same point in time.

Equals(DateTimeOffset)

Bestimmt, ob das aktuelle DateTimeOffset-Objekt denselben Zeitpunkt wie ein angegebenes DateTimeOffset-Objekt darstellt.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

public:
 virtual bool Equals(DateTimeOffset other);
public bool Equals (DateTimeOffset other);
override this.Equals : DateTimeOffset -> bool
Public Function Equals (other As DateTimeOffset) As Boolean

Parameter

other
DateTimeOffset

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

Gibt zurück

true, wenn beide DateTimeOffset-Objekte denselben UtcDateTime-Wert aufweisen, andernfalls false.true if both DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

Implementiert

Beispiele

Das folgende Beispiel veranschaulicht Aufrufe der Equals(DateTimeOffset)-Methode, um DateTimeOffset-Objekte auf Gleichheit mit dem aktuellen DateTimeOffset-Objekt zu testen.The following example illustrates calls to the Equals(DateTimeOffset) method to test DateTimeOffset objects for equality with the current DateTimeOffset object.

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

   DateTimeOffset secondTime = firstTime;
   Console.WriteLine("{0} = {1}: {2}", 
                     firstTime, secondTime, 
                     firstTime.Equals(secondTime));

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

   secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0, 
                    new TimeSpan(-5, 0, 0));
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
   // The example displays the following output to the console:
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -07:00: True
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -06:00: False
   //      9/1/2007 6:45:00 AM -07:00 = 9/1/2007 8:45:00 AM -05:00: True       
    Dim firstTime As New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                     New TimeSpan(-7, 0, 0))

    Dim secondTime As DateTimeOffset = firstTime
    Console.WriteLine("{0} = {1}: {2}", _
                      firstTime, secondTime, _
                      firstTime.Equals(secondTime))

    secondTime = New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                     New TimeSpan(-6, 0, 0))      
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))
    
    secondTime = New DateTimeOffset(#09/01/2007 8:45:00AM#, _
                     New TimeSpan(-5, 0, 0))
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))
    ' The example displays the following output to the console:
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -07:00: True
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -06:00: False
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 8:45:00 AM -05:00: True

Hinweise

Vor der Durchführung des Vergleichs konvertiert diese Methode die Werte beider DateTimeOffset Objekte in die koordinierte Weltzeit (UTC).Before it performs the comparison, this method converts the values of both DateTimeOffset objects to Coordinated Universal Time (UTC). Die-Methode entspricht Folgendem:The method is equivalent to the following:

return this.UtcDateTime == other.UtcDateTime;
Return Me.UtcDateTime = other.UtcDateTime

Mit anderen Worten: die Equals(DateTimeOffset)-Methode bestimmt, ob zwei DateTimeOffset-Objekte einen einzelnen Zeitpunkt darstellen.In other words, the Equals(DateTimeOffset) method determines whether two DateTimeOffset objects represent a single point in time. Er vergleicht weder Datums-und Uhrzeiten direkt noch Offsets.It directly compares neither dates and times nor offsets. Verwenden Sie die EqualsExact-Methode, um zu bestimmen, ob zwei DateTimeOffset-Objekte denselben Zeitpunkt darstellen und denselben Offset Wert aufweisen.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Ein DateTimeOffset Objekt, das nicht null ist, wird als später (oder größer) eingestuft als eines, das nullist.A DateTimeOffset object that is not null is considered to be later (or greater) than one that is null.

Diese Überladung der Equals(DateTimeOffset)-Methode implementiert die IEquatable<T>.Equals-Methode.This overload of the Equals(DateTimeOffset) method implements the IEquatable<T>.Equals method. Sie bietet eine etwas bessere Leistung als die DateTimeOffset.Equals(Object) Überladung, da der other Parameter nicht von einem Objekt konvertiert werden muss.It offers slightly better performance than the DateTimeOffset.Equals(Object) overload because the other parameter does not have to be converted from an object.

Siehe auch

Equals(Object)

Bestimmt, ob ein DateTimeOffset-Objekt denselben Zeitpunkt wie ein angegebenes Objekt darstellt.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

public:
 override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean

Parameter

obj
Object

Das Objekt, das mit dem aktuellen DateTimeOffset-Objekt verglichen werden soll.The object to compare to the current DateTimeOffset object.

Gibt zurück

true, wenn der obj-Parameter ein DateTimeOffset-Objekt ist und denselben Zeitpunkt wie das aktuelle DateTimeOffset-Objekt darstellt, andernfalls false.true if the obj parameter is a DateTimeOffset object and represents the same point in time as the current DateTimeOffset object; otherwise, false.

Beispiele

Das folgende Beispiel gibt an, ob das aktuelle DateTimeOffset Objekt gleich vielen anderen DateTimeOffset Objekten ist, sowie einen NULL-Verweis und ein DateTime-Objekt.The following example indicates whether the current DateTimeOffset object is equal to several other DateTimeOffset objects, as well as to a null reference and a DateTime object.

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

   object secondTime = firstTime;
   Console.WriteLine("{0} = {1}: {2}", 
                     firstTime, secondTime, 
                     firstTime.Equals(secondTime));

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

   secondTime = new DateTimeOffset(2007, 9, 1, 8, 45, 0, 
                    new TimeSpan(-5, 0, 0));
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
                    
   secondTime = null;
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));

   secondTime = new DateTime(2007, 9, 1, 6, 45, 00);                       
   Console.WriteLine("{0} = {1}: {2}", 
                    firstTime, secondTime, 
                    firstTime.Equals(secondTime));
   // The example displays the following output to the console:
   //       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -07:00: True  
   //       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -06:00: False 
   //       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 8:45:00 AM -05:00: True  
   //       9/1/2007 6:45:00 AM -07:00 = : False                           
   //       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM: False          
    Dim firstTime As New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                     New TimeSpan(-7, 0, 0))

    Dim secondTime As Object = firstTime
    Console.WriteLine("{0} = {1}: {2}", _
                      firstTime, secondTime, _
                      firstTime.Equals(secondTime))

    secondTime = New DateTimeOffset(#09/01/2007 6:45:00AM#, _
                     New TimeSpan(-6, 0, 0))      
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))
    
    secondTime = New DateTimeOffset(#09/01/2007 8:45:00AM#, _
                     New TimeSpan(-5, 0, 0))
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))
                     
    secondTime = Nothing
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))

    secondTime = #9/1/2007 6:45AM#
    Console.WriteLine("{0} = {1}: {2}", _
                     firstTime, secondTime, _
                     firstTime.Equals(secondTime))
                                 
    ' The example displays the following output to the console:
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -07:00: True  
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM -06:00: False 
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 8:45:00 AM -05:00: True  
    '       9/1/2007 6:45:00 AM -07:00 = : False                           
    '       9/1/2007 6:45:00 AM -07:00 = 9/1/2007 6:45:00 AM: False          

Hinweise

Vor der Durchführung des Vergleichs konvertiert diese Methode die Werte des aktuellen DateTimeOffset-Objekts und des obj-Parameters in eine koordinierte Weltzeit (UTC).Before it performs the comparison, this method converts the values of both the current DateTimeOffset object and the obj parameter to Coordinated Universal Time (UTC). Die-Methode entspricht Folgendem:The method is equivalent to the following:

return this.UtcDateTime == ((DateTimeOffset) obj).UtcDateTime;
Return Me.UtcDateTime = DirectCast(obj, DatetimeOffset).UtcDateTime

Mit anderen Worten: die DateTimeOffset.Equals(Object)-Methode bestimmt, ob das aktuelle DateTimeOffset-Objekt und ein angegebenes-Objekt einen bestimmten Zeitpunkt darstellen.In other words, the DateTimeOffset.Equals(Object) method determines whether the current DateTimeOffset object and a specified object represent a single point in time. Er vergleicht weder Datums-und Uhrzeiten direkt noch Offsets.It directly compares neither dates and times nor offsets. Verwenden Sie die EqualsExact-Methode, um zu bestimmen, ob zwei DateTimeOffset-Objekte denselben Zeitpunkt darstellen und denselben Offset Wert aufweisen.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Wenn obj nullist oder der Lauf Zeittyp von obj nicht DateTimeOffsetist, gibt die Methode falsezurück.If obj is null, or if the run-time type of obj is not DateTimeOffset, the method returns false.

Siehe auch

Equals(DateTimeOffset, DateTimeOffset)

Bestimmt, ob zwei angegebene DateTimeOffset-Objekte denselben Zeitpunkt darstellen.Determines whether two specified DateTimeOffset objects represent the same point in time.

public:
 static bool Equals(DateTimeOffset first, DateTimeOffset second);
public static bool Equals (DateTimeOffset first, DateTimeOffset second);
static member Equals : DateTimeOffset * DateTimeOffset -> bool
Public Shared Function Equals (first As DateTimeOffset, second As DateTimeOffset) As Boolean

Parameter

first
DateTimeOffset

Das erste zu vergleichende Objekt.The first object to compare.

second
DateTimeOffset

Das zweite zu vergleichende Objekt.The second object to compare.

Gibt zurück

true, wenn die beiden DateTimeOffset-Objekte denselben UtcDateTime-Wert aufweisen, andernfalls false.true if the two DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

Beispiele

Das folgende Beispiel veranschaulicht Aufrufe der Equals(DateTimeOffset, DateTimeOffset)-Methode, um verschiedene Paare von DateTimeOffset Objekten auf Gleichheit zu testen.The following example illustrates calls to the Equals(DateTimeOffset, DateTimeOffset) method to test various pairs of DateTimeOffset objects for equality.

DateTimeOffset firstTime = new DateTimeOffset(2007, 11, 15, 11, 35, 00, 
                                    DateTimeOffset.Now.Offset);
DateTimeOffset secondTime = firstTime;
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));

// The value of firstTime remains unchanged
secondTime = new DateTimeOffset(firstTime.DateTime, 
             TimeSpan.FromHours(firstTime.Offset.Hours + 1));      
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));
                        
// value of firstTime remains unchanged
secondTime = new DateTimeOffset(firstTime.DateTime + TimeSpan.FromHours(1), 
                                TimeSpan.FromHours(firstTime.Offset.Hours + 1));
Console.WriteLine("{0} = {1}: {2}", 
                  firstTime, secondTime, 
                  DateTimeOffset.Equals(firstTime, secondTime));
 // The example produces the following output:
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -07:00: True
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -06:00: False
 //       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 12:35:00 PM -06:00: True       
Dim firstTime As New DateTimeOffset(#11/15/2007 11:35AM#, _
                                    DateTimeOffset.Now.Offset)
Dim secondTime As DateTimeOffset = firstTime
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))

' The value of firstTime remains unchanged
secondTime = New DateTimeOffset(firstTime.DateTime, _
             TimeSpan.FromHours(firstTime.Offset.Hours + 1))      
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))

' value of firstTime remains unchanged
secondTime = New DateTimeOffset(firstTime.DateTime + TimeSpan.FromHours(1), _
                                TimeSpan.FromHours(firstTime.Offset.Hours + 1))
Console.WriteLine("{0} = {1}: {2}", _
                  firstTime, secondTime, _
                  DateTimeOffset.Equals(firstTime, secondTime))
 ' The example produces the following output:
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -07:00: True
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 11:35:00 AM -06:00: False
 '       11/15/2007 11:35:00 AM -07:00 = 11/15/2007 12:35:00 PM -06:00: True       

Hinweise

Vor der Durchführung des Vergleichs konvertiert diese Methode beide DateTimeOffset Objekte in eine koordinierte Weltzeit (UTC).Before it performs the comparison, this method converts both DateTimeOffset objects to Coordinated Universal Time (UTC). Die-Methode entspricht Folgendem:The method is equivalent to the following:

return first.UtcDateTime == second.UtcDateTime;
Return first.UtcDateTime = second.UtcDateTime

Mit anderen Worten: die Equals(DateTimeOffset, DateTimeOffset)-Methode bestimmt, ob die beiden DateTimeOffset-Objekte einen einzelnen Zeitpunkt darstellen.In other words, the Equals(DateTimeOffset, DateTimeOffset) method determines whether the two DateTimeOffset objects represent a single point in time. Er vergleicht weder Datums-und Uhrzeiten direkt noch Offsets.It directly compares neither dates and times nor offsets. Verwenden Sie die EqualsExact-Methode, um zu bestimmen, ob zwei DateTimeOffset-Objekte denselben Zeitpunkt darstellen und denselben Offset Wert aufweisen.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Siehe auch

Gilt für: