DateTime::Equals Method (DateTime, DateTime)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

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

static bool Equals(
	DateTime t1,
	DateTime t2


Type: System::DateTime

The first object to compare.

Type: System::DateTime

The second object to compare.

Return Value

Type: System::Boolean

true if the two values are equal; otherwise, false.

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

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top