Export (0) Print
Expand All

DateTime.Equals Method (DateTime, DateTime)

Updated: December 2010

Returns a value indicating whether two instances of DateTime are equal.

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

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 values are equal; otherwise, false.

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

The following example demonstrates the Equals method.

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Date

History

Reason

December 2010

Added a definition of date and time equality.

Customer feedback.

Community Additions

ADD
Show:
© 2014 Microsoft