DateTimeOffset.Equals DateTimeOffset.Equals DateTimeOffset.Equals DateTimeOffset.Equals Method

Definizione

Determina se due oggetti DateTimeOffset sono uguali oppure se un oggetto DateTimeOffset è uguale a un oggetto specificato.Determines whether two DateTimeOffset objects are equal, or a DateTimeOffset object is equal to a specified object.

Overload

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

Determina se l'oggetto DateTimeOffset corrente rappresenta la stessa data e ora dell'oggetto DateTimeOffset specificato.Determines whether the current DateTimeOffset object represents the same point in time as a specified DateTimeOffset object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se un oggetto DateTimeOffset rappresenta la stessa data e ora di un oggetto specificato.Determines whether a DateTimeOffset object represents the same point in time as a specified object.

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

Determina se due oggetti DateTimeOffset specificati rappresentano la stessa data e ora.Determines whether two specified DateTimeOffset objects represent the same point in time.

Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset) Equals(DateTimeOffset)

Determina se l'oggetto DateTimeOffset corrente rappresenta la stessa data e ora dell'oggetto DateTimeOffset specificato.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

Parametri

other
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Oggetto da confrontare con l'oggetto DateTimeOffset corrente.An object to compare to the current DateTimeOffset object.

Restituisce

true se entrambi gli oggetti DateTimeOffset presentano lo stesso valore UtcDateTime; in caso contrario, false.true if both DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

Implementazioni

Esempi

Nell'esempio seguente vengono illustrate le chiamate Equals(DateTimeOffset) al metodo per DateTimeOffset verificare l'uguaglianza degli oggetti con DateTimeOffset l'oggetto corrente.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

Commenti

Prima di eseguire il confronto, questo metodo converte i valori di entrambi DateTimeOffset gli oggetti in UTC (Coordinated Universal Time).Before it performs the comparison, this method converts the values of both DateTimeOffset objects to Coordinated Universal Time (UTC). Il metodo è equivalente al seguente:The method is equivalent to the following:

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

In altre parole, il Equals(DateTimeOffset) metodo determina se due DateTimeOffset oggetti rappresentano un singolo momento.In other words, the Equals(DateTimeOffset) method determines whether two DateTimeOffset objects represent a single point in time. Confronta direttamente le date e le ore, né gli offset.It directly compares neither dates and times nor offsets. Per determinare se due DateTimeOffset oggetti rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare EqualsExact il metodo.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Un DateTimeOffset oggetto che non null è considerato come successivo (o maggiore) di uno che è null.A DateTimeOffset object that is not null is considered to be later (or greater) than one that is null.

Questo overload del Equals(DateTimeOffset) metodo implementa il IEquatable<T>.Equals metodo.This overload of the Equals(DateTimeOffset) method implements the IEquatable<T>.Equals method. Offre prestazioni leggermente migliori rispetto all' DateTimeOffset.Equals(Object) overload perché il other parametro non deve essere convertito da un oggetto.It offers slightly better performance than the DateTimeOffset.Equals(Object) overload because the other parameter does not have to be converted from an object.

Vedi anche

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se un oggetto DateTimeOffset rappresenta la stessa data e ora di un oggetto specificato.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

Parametri

obj
Object Object Object Object

Oggetto da confrontare con l'oggetto DateTimeOffset corrente.The object to compare to the current DateTimeOffset object.

Restituisce

true se il parametro obj è un oggetto DateTimeOffset che rappresenta la stessa data e ora dell'oggetto DateTimeOffset corrente; in caso contrario, false.true if the obj parameter is a DateTimeOffset object and represents the same point in time as the current DateTimeOffset object; otherwise, false.

Esempi

Nell'esempio seguente viene indicato se l' DateTimeOffset oggetto corrente è uguale a diversi DateTimeOffset altri oggetti, nonché a un riferimento null e a un DateTime oggetto.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          

Commenti

Prima di eseguire il confronto, questo metodo converte i valori dell'oggetto corrente DateTimeOffset e del obj parametro in formato UTC (Coordinated Universal Time).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). Il metodo è equivalente al seguente:The method is equivalent to the following:

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

In altre parole, il DateTimeOffset.Equals(Object) metodo determina se l'oggetto DateTimeOffset corrente e un oggetto specificato rappresentano un singolo momento.In other words, the DateTimeOffset.Equals(Object) method determines whether the current DateTimeOffset object and a specified object represent a single point in time. Confronta direttamente le date e le ore, né gli offset.It directly compares neither dates and times nor offsets. Per determinare se due DateTimeOffset oggetti rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare EqualsExact il metodo.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Se obj obj è nullo se il tipo in fase di esecuzione di non DateTimeOffsetè, il metodo restituisce false.If obj is null, or if the run-time type of obj is not DateTimeOffset, the method returns false.

Vedi anche

Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset) Equals(DateTimeOffset, DateTimeOffset)

Determina se due oggetti DateTimeOffset specificati rappresentano la stessa data e ora.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

Parametri

first
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Primo oggetto da confrontare.The first object to compare.

second
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Secondo oggetto da confrontare.The second object to compare.

Restituisce

true se i due oggetti DateTimeOffset presentano lo stesso valore UtcDateTime; in caso contrario, false.true if the two DateTimeOffset objects have the same UtcDateTime value; otherwise, false.

Esempi

Nell'esempio seguente vengono illustrate le chiamate Equals(DateTimeOffset, DateTimeOffset) al metodo per verificare l'uguaglianza DateTimeOffset di varie coppie di oggetti.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       

Commenti

Prima di eseguire il confronto, questo metodo converte entrambi DateTimeOffset gli oggetti in UTC (Coordinated Universal Time).Before it performs the comparison, this method converts both DateTimeOffset objects to Coordinated Universal Time (UTC). Il metodo è equivalente al seguente:The method is equivalent to the following:

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

In altre parole, il Equals(DateTimeOffset, DateTimeOffset) metodo determina se i due DateTimeOffset oggetti rappresentano un singolo momento.In other words, the Equals(DateTimeOffset, DateTimeOffset) method determines whether the two DateTimeOffset objects represent a single point in time. Confronta direttamente le date e le ore, né gli offset.It directly compares neither dates and times nor offsets. Per determinare se due DateTimeOffset oggetti rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare EqualsExact il metodo.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Vedi anche

Si applica a