DateTime.Equals Метод

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

Имя	Описание
Equals(DateTime)	Возвращает значение, указывающее, равно ли значение этого экземпляра значению указанного DateTime экземпляра.
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.
Equals(DateTime, DateTime)	Возвращает значение, указывающее, имеют ли два DateTime экземпляра одно и то же значение даты и времени.

Equals(DateTime)

Исходный код:

DateTime.cs

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

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

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

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

Boolean

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

Реализации

Equals(T)

Примеры

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

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.

Комментарии

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

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

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

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

Equals(Object)

Исходный код:

DateTime.cs

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

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

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

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

Boolean

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

Примеры

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

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.

Комментарии

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

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

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

Equals(DateTime, DateTime)

Исходный код:

DateTime.cs

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

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

Первый объект для сравнения.

t2

DateTime

Второй объект для сравнения.

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

Boolean

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

Примеры

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

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)

Комментарии

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

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

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