DateTime.Equals DateTime.Equals DateTime.Equals DateTime.Equals Method

Определение

Возвращает значение, указывающее, имеют ли два объекта DateTime или экземпляр DateTime и другой объект либо DateTime одинаковые значения.Returns a value indicating whether two DateTime objects, or a DateTime instance and another object or DateTime, have the same value.

Перегрузки

Equals(DateTime, DateTime) Equals(DateTime, DateTime) Equals(DateTime, DateTime) Equals(DateTime, DateTime)

Возвращает значение, указывающее, содержат ли два экземпляра DateTime одно и то же значение даты и времени.Returns a value indicating whether two DateTime instances have the same date and time value.

Equals(DateTime) Equals(DateTime) Equals(DateTime) Equals(DateTime)

Возвращает значение, указывающее, равно ли значение данного экземпляра значению заданного экземпляра DateTime.Returns a value indicating whether the value of this instance is equal to the value of the specified DateTime instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.Returns a value indicating whether this instance is equal to a specified object.

Equals(DateTime, DateTime) Equals(DateTime, DateTime) Equals(DateTime, DateTime) Equals(DateTime, DateTime)

Возвращает значение, указывающее, содержат ли два экземпляра DateTime одно и то же значение даты и времени.Returns a value indicating whether two DateTime instances have the same date and time value.

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

Параметры

t1
DateTime DateTime DateTime DateTime

Первый из сравниваемых объектов.The first object to compare.

t2
DateTime DateTime DateTime DateTime

Второй из сравниваемых объектов.The second object to compare.

Возвраты

Значение true, если два значения равны; в противном случае — значение false.true if the two values are equal; otherwise, false.

Примеры

В следующем примере демонстрируется Equals метод.The following example demonstrates the Equals method.

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)

Комментарии

t1и t2 равны, если их Ticks значения свойств равны.t1 and t2 are equal if their Ticks property values are equal. Значения Kind их свойств не учитываются при проверке на равенство.Their Kind property values are not considered in the test for equality.

Дополнительно

Equals(DateTime) Equals(DateTime) Equals(DateTime) Equals(DateTime)

Возвращает значение, указывающее, равно ли значение данного экземпляра значению заданного экземпляра DateTime.Returns a value indicating whether the value of this instance is equal to the value of the specified 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

Параметры

value
DateTime DateTime DateTime DateTime

Объект, сравниваемый с этим экземпляром.The object to compare to this instance.

Возвраты

Значение true, если параметр value равен значению этого экземпляра; в противном случае — значение false.true if the value parameter equals the value of this instance; otherwise, false.

Реализации

Примеры

В следующем примере демонстрируется Equals метод.The following example demonstrates the Equals method.

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.

Комментарии

Текущий экземпляр и value равны, если их Ticks значения свойств равны.The current instance and value are equal if their Ticks property values are equal. Значения Kind их свойств не учитываются при проверке на равенство.Their Kind property values are not considered in the test for equality.

Этот метод реализует System.IEquatable<T> интерфейс и работает немного лучше, Equals чем метод, поскольку value параметр не нужно преобразовывать в объект.This method implements the System.IEquatable<T> interface, and performs slightly better than the Equals method because the value parameter does not have to be converted to an object.

Дополнительно

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.Returns a value indicating whether this instance is equal to a specified object.

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

Параметры

value
Object Object Object Object

Объект, сравниваемый с этим экземпляром.The object to compare to this instance.

Возвраты

Значение true, если параметр value является экземпляром типа DateTime и равен значению данного экземпляра; в противном случае — значение false.true if value is an instance of DateTime and equals the value of this instance; otherwise, false.

Примеры

В следующем примере демонстрируется Equals метод.The following example demonstrates the Equals method.

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.

Комментарии

Текущий экземпляр и value равны, если их Ticks значения свойств равны.The current instance and value are equal if their Ticks property values are equal. Значения Kind их свойств не учитываются при проверке на равенство.Their Kind property values are not considered in the test for equality.

Дополнительно

Применяется к