Прочитать на английском

Поделиться через


DateTime.Equals Метод

Определение

Возвращает значение, указывающее, имеют ли два объекта DateTime или экземпляр DateTime и другой объект либо DateTime одинаковые значения.

Перегрузки

Equals(DateTime)

Возвращает значение, указывающее, равно ли значение данного экземпляра значению заданного экземпляра DateTime.

Equals(Object)

Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.

Equals(DateTime, DateTime)

Возвращает значение, указывающее, имеют ли два DateTime экземпляра одинаковые значения даты и времени.

Equals(DateTime)

Исходный код:
DateTime.cs
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs

Возвращает значение, указывающее, равно ли значение данного экземпляра значению заданного экземпляра DateTime.

C#
public bool Equals (DateTime value);

Параметры

value
DateTime

Объект, сравниваемый с этим экземпляром.

Возвращаемое значение

Значение true, если параметр value равен значению этого экземпляра; в противном случае — значение false.

Реализации

Примеры

В следующем примере демонстрируется Equals метод.

C#
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.

Комментарии

Текущий экземпляр и value равны, если значения их Ticks свойств равны. Их Kind значения свойств не учитываются при проверке на равенство.

Этот метод реализует System.IEquatable<T> интерфейс и работает немного лучше, чем Equals метод , так как value параметр не требуется преобразовывать в объект .

См. также раздел

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Equals(Object)

Исходный код:
DateTime.cs
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs

Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.

C#
public override bool Equals (object value);
C#
public override bool Equals (object? value);

Параметры

value
Object

Объект, сравниваемый с этим экземпляром.

Возвращаемое значение

Значение true, если параметр value является экземпляром типа DateTime и равен значению данного экземпляра; в противном случае — значение false.

Примеры

В следующем примере демонстрируется Equals метод.

C#
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.

Комментарии

Текущий экземпляр и value равны, если значения их Ticks свойств равны. Их Kind значения свойств не учитываются при проверке на равенство.

См. также раздел

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Equals(DateTime, DateTime)

Исходный код:
DateTime.cs
Исходный код:
DateTime.cs
Исходный код:
DateTime.cs

Возвращает значение, указывающее, имеют ли два DateTime экземпляра одинаковые значения даты и времени.

C#
public static bool Equals (DateTime t1, DateTime t2);

Параметры

t1
DateTime

Первый из сравниваемых объектов.

t2
DateTime

Второй из сравниваемых объектов.

Возвращаемое значение

Значение true, если два значения равны; в противном случае — значение false.

Примеры

В следующем примере демонстрируется Equals метод.

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

Комментарии

t1 и t2 равны, если значения их Ticks свойств равны. Их Kind значения свойств не учитываются при проверке на равенство.

См. также раздел

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0