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;否则为 falsetrue 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如果t2Ticks属性值相等,则和相等。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;否则为 falsetrue 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 属性值相等,则为该实例和相等。TicksThe 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.

返回

如果 truevalue 的实例并且等于此实例的值,则为 DateTime;否则为 falsetrue 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 属性值相等,则为该实例和相等。TicksThe 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.

另请参阅

适用于