DateTime.Equals Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Retourne une valeur indiquant si deux objets DateTime, ou si une instance de DateTime et un autre objet ou DateTime ont la même valeur.

Surcharges

Equals(DateTime, DateTime)	Retourne une valeur indiquant si deux instances de DateTime représentent la même valeur de date et d'heure.
Equals(DateTime)	Renvoie une valeur indiquant si la valeur de cette instance est égale à la valeur de l'instance DateTime spécifiée.
Equals(Object)	Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.

Equals(DateTime, DateTime)

Retourne une valeur indiquant si deux instances de DateTime représentent la même valeur de date et d'heure.

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

Paramètres

t1

DateTime

Premier objet à comparer.

t2

DateTime

Deuxième objet à comparer.

Retours

Boolean

true si les deux valeurs sont égales ; sinon, false.

Exemples

L’exemple suivant illustre la Equals méthode.

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)

Remarques

t1 et t2 sont égaux si leurs Ticks valeurs de propriété sont égales. Leurs Kind valeurs de propriété ne sont pas considérées comme égales dans le test.

Voir aussi

• Boolean
• Compare(DateTime, DateTime)
• CompareTo(Object)

Equals(DateTime)

Renvoie une valeur indiquant si la valeur de cette instance est égale à la valeur de l'instance DateTime spécifiée.

public:
 virtual bool Equals(DateTime value);

public bool Equals (DateTime value);

override this.Equals : DateTime -> bool

Public Function Equals (value As DateTime) As Boolean

Paramètres

value

DateTime

Objet à comparer à cette instance.

Retours

Boolean

true si le paramètre value est égal à la valeur de cette instance ; sinon, false.

Implémente

Equals(T)

Exemples

L’exemple suivant illustre la Equals méthode.

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.

Remarques

L’instance actuelle et value sont égaux si leurs Ticks valeurs de propriété sont égales. Leurs Kind valeurs de propriété ne sont pas considérées comme égales dans le test.

Cette méthode implémente l' System.IEquatable<T> interface et s’exécute légèrement mieux que la Equals méthode, car le value paramètre n’a pas besoin d’être converti en objet.

Voir aussi

• Equals(Object)
• Compare(DateTime, DateTime)
• CompareTo(Object)

Equals(Object)

Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.

public:
 override bool Equals(System::Object ^ value);

public override bool Equals (object value);

public override bool Equals (object? value);

override this.Equals : obj -> bool

Public Overrides Function Equals (value As Object) As Boolean

Paramètres

value

Object

Objet à comparer à cette instance.

Retours

Boolean

true si value est une instance de DateTime et est égal à la valeur de cette instance ; sinon, false.

Exemples

L’exemple suivant illustre la Equals méthode.

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.

Remarques

L’instance actuelle et value sont égaux si leurs Ticks valeurs de propriété sont égales. Leurs Kind valeurs de propriété ne sont pas considérées comme égales dans le test.

Voir aussi

• Compare(DateTime, DateTime)
• CompareTo(Object)