DateTime.Equals Method (DateTime, DateTime)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

Syntax

Public Shared Function Equals ( _
    t1 As DateTime, _
    t2 As DateTime _
) As Boolean
public static bool Equals(
    DateTime t1,
    DateTime t2
)

Parameters

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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

DateTime Structure

Equals Overload

System Namespace

Boolean

Compare

CompareTo