DateTime.Equals Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Sestavení:

netstandard.dll

Sestavení:

mscorlib.dll

Vrátí hodnotu, která označuje, zda dva DateTime objekty, nebo DateTime instance a jiný objekt DateTime mají stejnou hodnotu.

Přetížení

Equals(DateTime, DateTime)	Vrátí hodnotu, která označuje, zda dvě DateTime instance mají stejnou hodnotu data a času.
Equals(DateTime)	Vrátí hodnotu, která označuje, zda je hodnota této instance rovna hodnotě zadané DateTime instance.
Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

Equals(DateTime, DateTime)

Vrátí hodnotu, která označuje, zda dvě DateTime instance mají stejnou hodnotu data a času.

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

Parametry

t1

DateTime

První objekt k porovnání

t2

DateTime

Druhý objekt k porovnání

Návraty

Boolean

true Pokud jsou tyto dvě hodnoty stejné; v opačném případě false .

Příklady

Následující příklad ukazuje Equals metodu.

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)

Poznámky

t1 a t2 jsou shodné, pokud Ticks jsou hodnoty jejich vlastností stejné. KindHodnoty jejich vlastností nejsou v testu pro rovnosti zváženy.

Viz také

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

Equals(DateTime)

Vrátí hodnotu, která označuje, zda je hodnota této instance rovna hodnotě zadané DateTime instance.

public:
 virtual bool Equals(DateTime value);

public bool Equals (DateTime value);

override this.Equals : DateTime -> bool

Public Function Equals (value As DateTime) As Boolean

Parametry

value

DateTime

Objekt, který se má porovnat s touto instancí.

Návraty

Boolean

true Pokud se value parametr rovná hodnotě této instance; v opačném případě false .

Implementuje

Equals(T)

Příklady

Následující příklad ukazuje Equals metodu.

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.

Poznámky

Aktuální instance a value jsou stejné, pokud Ticks jsou hodnoty jejich vlastností stejné. KindHodnoty jejich vlastností nejsou v testu pro rovnosti zváženy.

Tato metoda implementuje System.IEquatable<T> rozhraní a provádí mírně lepší než Equals metodu, protože value parametr není nutné převést na objekt.

Viz také

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

Equals(Object)

Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu.

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

Parametry

value

Object

Objekt, který se má porovnat s touto instancí.

Návraty

Boolean

true Pokud value je instance DateTime a rovna hodnotě této instance; v opačném případě false .

Příklady

Následující příklad ukazuje Equals metodu.

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.

Poznámky

Aktuální instance a value jsou stejné, pokud Ticks jsou hodnoty jejich vlastností stejné. KindHodnoty jejich vlastností nejsou v testu pro rovnosti zváženy.

Viz také

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