DateTime.Equals Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

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

Surcharges

Nom	Description
Equals(DateTime)	Retourne une valeur indiquant si la valeur de cette instance est égale à la valeur de l’instance spécifiée DateTime .
Equals(Object)	Retourne une valeur indiquant si cette instance est égale à un objet spécifié.
Equals(DateTime, DateTime)	Retourne une valeur indiquant si deux DateTime instances ont la même valeur de date et d’heure.

Equals(DateTime)

Source:

DateTime.cs

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

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 value paramètre 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.

open System

// Create some DateTime objects.
let one = DateTime.UtcNow

let two = DateTime.Now

let three = one

// Compare the DateTime objects and display the results.
let result = one.Equals two

printfn $"The result of comparing DateTime object one and two is: {result}."

let result2 = one.Equals three

printfn $"The result of comparing DateTime object one and three is: {result2}."

// 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 est égale si leurs Ticks valeurs de propriété sont égales. Leurs Kind valeurs de propriété ne sont pas prises en compte dans le test d’égalité.

Cette méthode implémente l’interface System.IEquatable<T> et effectue 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)

Source:

DateTime.cs

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

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

Paramètres

value

Object

Objet à comparer à cette instance.

Retours

Boolean

true si value est une instance de DateTime cette instance et est égale à 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.

open System

// Create some DateTime objects.
let one = DateTime.UtcNow

let two = DateTime.Now

let three = one

// Compare the DateTime objects and display the results.
let result = one.Equals two

printfn $"The result of comparing DateTime object one and two is: {result}."

let result2 = one.Equals three

printfn $"The result of comparing DateTime object one and three is: {result2}."

// 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 est égale si leurs Ticks valeurs de propriété sont égales. Leurs Kind valeurs de propriété ne sont pas prises en compte dans le test d’égalité.

Voir aussi

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

Equals(DateTime, DateTime)

Source:

DateTime.cs

Retourne une valeur indiquant si deux DateTime instances ont 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.

let today1 = 
    System.DateTime System.DateTime.Today.Ticks

let today2 =
    System.DateTime System.DateTime.Today.Ticks

let tomorrow =
    System.DateTime.Today.AddDays(1).Ticks
    |> System.DateTime 

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

// todayEqualsTomorrow gets false.
let 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 prises en compte dans le test d’égalité.

Voir aussi

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