DateTime.Equals Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Gibt einen Wert zurück, der angibt, ob zwei DateTime-Objekte oder eine DateTime-Instand und ein anderes Objekt oder DateTime den selben Wert besitzen.

Überlädt

Equals(DateTime)	Gibt einen Wert zurück, der angibt, ob der Wert dieser Instanz gleich dem Wert der angegebenen DateTime-Instanz ist.
Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.
Equals(DateTime, DateTime)	Gibt einen Wert zurück, der angibt, ob zwei DateTime Instanzen über denselben Datums- und Uhrzeitwert verfügen.

Equals(DateTime)

Quelle:

DateTime.cs

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

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 mit dieser Instanz zu vergleichende Objekt.

Gibt zurück

Boolean

true, wenn value dem Wert dieser Instanz entspricht, andernfalls false.

Implementiert

Equals(T)

Beispiele

Das folgende Beispiel veranschaulicht die Equals Methode.

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 ist etwas besser 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 gleich einem angegebenen Objekt ist.

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 mit dieser Instanz zu vergleichende Objekt.

Gibt zurück

Boolean

true, wenn value eine Instanz von DateTime ist, deren Wert gleich dem Wert dieser Instanz ist, andernfalls false.

Beispiele

Das folgende Beispiel veranschaulicht die Equals Methode.

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 über denselben Datums- und Uhrzeitwert verfügen.

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

true, wenn die beiden Werte gleich sind, andernfalls false.

Beispiele

Das folgende Beispiel veranschaulicht die Equals Methode.

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

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)