DateTime.Equals Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Gibt einen Wert zurück, der angibt, ob zwei DateTime Objekte oder eine Instanz und ein DateTime anderes Objekt oder DateTimeein anderes Objekt denselben Wert aufweisen.

Überlädt

Name	Beschreibung
Equals(DateTime)	Gibt einen Wert zurück, der angibt, ob der Wert dieser Instanz dem Wert der angegebenen DateTime Instanz entspricht.
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.
Equals(DateTime, DateTime)	Gibt einen Wert zurück, der angibt, ob zwei DateTime Instanzen denselben Datums- und Uhrzeitwert aufweisen.

Equals(DateTime)

Quelle:

DateTime.cs

Gibt einen Wert zurück, der angibt, ob der Wert dieser Instanz dem Wert der angegebenen DateTime Instanz entspricht.

public:
 virtual bool Equals(DateTime value);

public bool Equals(DateTime value);

override this.Equals : DateTime -> bool

Public Function Equals (value As DateTime) As Boolean

Parameter

value

DateTime

Das Objekt, das mit dieser Instanz verglichen werden soll.

Gibt zurück

Boolean

truewenn der value Parameter dem Wert dieser Instanz entspricht; andernfalls . false

Implementiert

Equals(T)

Beispiele

Im folgenden Beispiel wird die Equals Methode veranschaulicht.

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.

Hinweise

Die aktuelle Instanz und value sind gleich, wenn ihre Ticks Eigenschaftswerte gleich sind. Ihre Kind Eigenschaftswerte werden im Test auf Gleichheit nicht berücksichtigt.

Diese Methode implementiert die System.IEquatable<T> Schnittstelle und führt etwas besser aus als die Equals Methode, da der value Parameter nicht in ein Objekt konvertiert werden muss.

Weitere Informationen

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

Equals(Object)

Quelle:

DateTime.cs

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

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

Parameter

value

Object

Das Objekt, das mit dieser Instanz verglichen werden soll.

Gibt zurück

Boolean

true if value is an instance of DateTime and equals the value of this instance; otherwise, false.

Beispiele

Im folgenden Beispiel wird die Equals Methode veranschaulicht.

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.

Hinweise

Die aktuelle Instanz und value sind gleich, wenn ihre Ticks Eigenschaftswerte gleich sind. Ihre Kind Eigenschaftswerte werden im Test auf Gleichheit nicht berücksichtigt.

Weitere Informationen

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

Equals(DateTime, DateTime)

Quelle:

DateTime.cs

Gibt einen Wert zurück, der angibt, ob zwei DateTime Instanzen denselben Datums- und Uhrzeitwert aufweisen.

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

Parameter

t1

DateTime

Das erste zu vergleichende Objekt.

t2

DateTime

Das zweite zu vergleichende Objekt.

Gibt zurück

Boolean

truewenn die beiden Werte gleich sind; andernfalls . false

Beispiele

Im folgenden Beispiel wird die Equals Methode veranschaulicht.

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)

Hinweise

t1 und t2 sind gleich, wenn ihre Ticks Eigenschaftswerte gleich sind. Ihre Kind Eigenschaftswerte werden im Test auf Gleichheit nicht berücksichtigt.

Weitere Informationen

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