DateTime.Equals Method (DateTime, DateTime)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Updated: December 2010

Returns a value indicating whether two DateTime instances have the same date and time value.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function Equals ( _
    t1 As DateTime, _
    t2 As DateTime _
) As Boolean

public static bool Equals(
    DateTime t1,
    DateTime t2
)

Parameters

• t1
  Type: System.DateTime
  The first object to compare.

• t2
  Type: System.DateTime
  The second object to compare.

Return Value

Type: System.Boolean
true if the two DateTime values are equal; otherwise, false.

Remarks

t1 and t2 are equal if their Ticks property values are equal. Their Kind property values are not considered in the test for equality.

Examples

The following example demonstrates the Equals method.

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)

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also

Reference

DateTime Structure

Equals Overload

System Namespace

Boolean

Compare

CompareTo

Change History

Date	History	Reason
December 2010	Added a definition of date and time equality.	Customer feedback.