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.

C#

public static bool Equals (DateTime t1, DateTime t2);

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.

C#

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);

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.

C#

public bool Equals (DateTime value);

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.

C#

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.

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é.

C#

public override bool Equals (object value);

C#

public override bool Equals (object? value);

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.

C#

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.

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)