DateTimeOffset.Equals Metodo

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)

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)

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)

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)

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

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 al metodo Equals(DateTimeOffset) per testare DateTimeOffset oggetti per verificarne l'uguaglianza con l'oggetto DateTimeOffset 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 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 metodo Equals(DateTimeOffset) determina se due oggetti DateTimeOffset 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 oggetti DateTimeOffset rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare il metodo EqualsExact.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

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

Questo overload del metodo Equals(DateTimeOffset) implementa il metodo IEquatable<T>.Equals.This overload of the Equals(DateTimeOffset) method implements the IEquatable<T>.Equals method. Offre prestazioni leggermente migliori rispetto all'overload DateTimeOffset.Equals(Object) perché non è necessario convertire il parametro other 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)

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

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'oggetto DateTimeOffset corrente è uguale a diversi altri oggetti DateTimeOffset, nonché a un riferimento null e a un oggetto DateTime.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 DateTimeOffset corrente e del parametro obj in ora 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 metodo DateTimeOffset.Equals(Object) 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 oggetti DateTimeOffset rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare il metodo EqualsExact.To determine whether two DateTimeOffset objects represent the same time and have the same offset value, use the EqualsExact method.

Se obj è nullo se il tipo in fase di esecuzione di obj 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)

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

Primo oggetto da confrontare.The first object to compare.

second
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 al metodo Equals(DateTimeOffset, DateTimeOffset) per testare le varie coppie di oggetti DateTimeOffset per verificarne l'uguaglianza.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 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 metodo Equals(DateTimeOffset, DateTimeOffset) determina se i due oggetti DateTimeOffset 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 oggetti DateTimeOffset rappresentano la stessa ora e hanno lo stesso valore di offset, utilizzare il metodo EqualsExact.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