Compares two instances of DateTime and returns an integer that indicates whether the first instance is earlier than, the same as, or later than the second instance.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- t1
- Type: System.DateTime
The first object to compare.
- t2
- Type: System.DateTime
The second object to compare.
Return Value
Type: System.Int32A signed number indicating the relative values of t1 and t2.
Value Type | Condition |
|---|---|
Less than zero | t1 is earlier than t2. |
Zero | t1 is the same as t2. |
Greater than zero | t1 is later than t2. |
Before comparing DateTime objects, ensure that the objects represent times in the same time zone.
The following example demonstrates the Compare method.
DateTime date1 = new DateTime(2009, 8, 1, 0, 0, 0); DateTime date2 = new DateTime(2009, 8, 1, 12, 0, 0); int result = DateTime.Compare(date1, date2); string relationship; if (result < 0) relationship = "is earlier than"; else if (result == 0) relationship = "is the same time as"; else relationship = "is later than"; Console.WriteLine("{0} {1} {2}", date1, relationship, date2); // The example displays the following output: // 8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
