DateTime.Equals Metodo

Definizione

Restituisce un valore che indica se due oggetti DateTime o un'istanza di DateTime e un oggetto di altro tipo o DateTime presentano lo stesso valore.Returns a value indicating whether two DateTime objects, or a DateTime instance and another object or DateTime, have the same value.

Overload

Equals(DateTime, DateTime)

Restituisce un valore che indica se due istanze di DateTime presentano lo stesso valore di data e ora.Returns a value indicating whether two DateTime instances have the same date and time value.

Equals(DateTime)

Restituisce un valore che indica se il valore di questa istanza è uguale al valore dell'istanza di DateTime specificata.Returns a value indicating whether the value of this instance is equal to the value of the specified DateTime instance.

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value indicating whether this instance is equal to a specified object.

Equals(DateTime, DateTime)

Restituisce un valore che indica se due istanze di DateTime presentano lo stesso valore di data e ora.Returns a value indicating whether two DateTime instances have the same date and time value.

public:
 static bool Equals(DateTime t1, DateTime t2);
public static bool Equals (DateTime t1, DateTime t2);
static member Equals : DateTime * DateTime -> bool
Public Shared Function Equals (t1 As DateTime, t2 As DateTime) As Boolean

Parametri

t1
DateTime

Primo oggetto da confrontare.The first object to compare.

t2
DateTime

Secondo oggetto da confrontare.The second object to compare.

Restituisce

true se i due valori sono uguali; in caso contrario, false.true if the two values are equal; otherwise, false.

Esempi

Nell'esempio seguente viene illustrato il metodo Equals.The following example demonstrates the Equals method.

System::DateTime today1 = System::DateTime(
   System::DateTime::Today.Ticks );
System::DateTime today2 = System::DateTime(
   System::DateTime::Today.Ticks );
System::DateTime tomorrow = System::DateTime(
   System::DateTime::Today.AddDays( 1 ).Ticks );

// todayEqualsToday gets true.
bool todayEqualsToday = System::DateTime::Equals( today1, today2 );

// todayEqualsTomorrow gets false.
bool todayEqualsTomorrow = System::DateTime::Equals( today1, tomorrow );
System.DateTime today1 = 
        new System.DateTime(System.DateTime.Today.Ticks);
System.DateTime today2 = 
        new System.DateTime(System.DateTime.Today.Ticks);
System.DateTime tomorrow = 
        new System.DateTime(
                    System.DateTime.Today.AddDays(1).Ticks);

// todayEqualsToday gets true.
bool todayEqualsToday = System.DateTime.Equals(today1, today2);

// todayEqualsTomorrow gets false.
bool todayEqualsTomorrow = System.DateTime.Equals(today1, tomorrow);
Dim today1 As New System.DateTime(System.DateTime.Today.Ticks)
Dim today2 As New System.DateTime(System.DateTime.Today.Ticks)
Dim tomorrow As New System.DateTime( _
                        System.DateTime.Today.AddDays(1).Ticks)

' todayEqualsToday gets true.
Dim todayEqualsToday As Boolean = System.DateTime.Equals(today1, today2)

' todayEqualsTomorrow gets false.
Dim todayEqualsTomorrow As Boolean = System.DateTime.Equals(today1, tomorrow)

Commenti

t1 e t2 sono uguali se i valori delle proprietà Ticks sono uguali.t1 and t2 are equal if their Ticks property values are equal. I valori delle proprietà Kind non vengono considerati nel test per verificarne l'uguaglianza.Their Kind property values are not considered in the test for equality.

Vedi anche

Equals(DateTime)

Restituisce un valore che indica se il valore di questa istanza è uguale al valore dell'istanza di DateTime specificata.Returns a value indicating whether the value of this instance is equal to the value of the specified DateTime instance.

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

Parametri

value
DateTime

Oggetto da confrontare con questa istanza.The object to compare to this instance.

Restituisce

true se il parametro value è uguale al valore di questa istanza; in caso contrario, false.true if the value parameter equals the value of this instance; otherwise, false.

Implementazioni

Esempi

Nell'esempio seguente viene illustrato il metodo Equals.The following example demonstrates the Equals method.

using System;

public class Application
{
    public static void Main()
    {
        // Create some DateTime objects.
        DateTime one = DateTime.UtcNow;

        DateTime two = DateTime.Now;

        DateTime three = one;

        // Compare the DateTime objects and display the results.
        bool result = one.Equals(two);

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result);

        result = one.Equals(three);

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result);
    }
}

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.
Module Application

    Sub Main()
        ' Create some DateTime objects.
        Dim one As DateTime = DateTime.UtcNow

        Dim two As DateTime = DateTime.Now

        Dim three As DateTime = one

        ' Compare the DateTime objects and display the results.
        Dim result As Boolean = one.Equals(two)

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result)

        result = one.Equals(three)

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result)

    End Sub
End Module

' This code example displays the following:
'
' The result of comparing DateTime object one and two is: False.
' The result of comparing DateTime object one and three is: True.

Commenti

L'istanza corrente e value sono uguali se i valori delle proprietà Ticks sono uguali.The current instance and value are equal if their Ticks property values are equal. I valori delle proprietà Kind non vengono considerati nel test per verificarne l'uguaglianza.Their Kind property values are not considered in the test for equality.

Questo metodo implementa l'interfaccia System.IEquatable<T> e offre prestazioni leggermente migliori rispetto al metodo Equals perché il parametro value non deve essere convertito in un oggetto.This method implements the System.IEquatable<T> interface, and performs slightly better than the Equals method because the value parameter does not have to be converted to an object.

Vedi anche

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value indicating whether this instance is equal to a specified object.

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

Parametri

value
Object

Oggetto da confrontare con questa istanza.The object to compare to this instance.

Restituisce

true se value è un'istanza di DateTime ed è uguale al valore dell'istanza; in caso contrario, false.true if value is an instance of DateTime and equals the value of this instance; otherwise, false.

Esempi

Nell'esempio seguente viene illustrato il metodo Equals.The following example demonstrates the Equals method.

using System;

public class Application
{
    public static void Main()
    {
        // Create some DateTime objects.
        DateTime one = DateTime.UtcNow;

        DateTime two = DateTime.Now;

        DateTime three = one;

        // Compare the DateTime objects and display the results.
        bool result = one.Equals(two);

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result);

        result = one.Equals(three);

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result);
    }
}

// This code example displays the following:
//
// The result of comparing DateTime object one and two is: False.
// The result of comparing DateTime object one and three is: True.
Module Application

    Sub Main()
        ' Create some DateTime objects.
        Dim one As DateTime = DateTime.UtcNow

        Dim two As DateTime = DateTime.Now

        Dim three As DateTime = one

        ' Compare the DateTime objects and display the results.
        Dim result As Boolean = one.Equals(two)

        Console.WriteLine("The result of comparing DateTime object one and two is: {0}.", result)

        result = one.Equals(three)

        Console.WriteLine("The result of comparing DateTime object one and three is: {0}.", result)

    End Sub
End Module

' This code example displays the following:
'
' The result of comparing DateTime object one and two is: False.
' The result of comparing DateTime object one and three is: True.

Commenti

L'istanza corrente e value sono uguali se i valori delle proprietà Ticks sono uguali.The current instance and value are equal if their Ticks property values are equal. I valori delle proprietà Kind non vengono considerati nel test per verificarne l'uguaglianza.Their Kind property values are not considered in the test for equality.

Vedi anche

Si applica a