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