Article
11/17/2011

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.

Change History

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

Share via