DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) DateTime.Compare(DateTime, DateTime) Method

定义

对两个 DateTime 的实例进行比较,并返回一个指示第一个实例是早于、等于还是晚于第二个实例的整数。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.

public:
 static int Compare(DateTime t1, DateTime t2);
public static int Compare (DateTime t1, DateTime t2);
static member Compare : DateTime * DateTime -> int
Public Shared Function Compare (t1 As DateTime, t2 As DateTime) As Integer

参数

t1
DateTime DateTime DateTime DateTime

要比较的第一个对象。The first object to compare.

t2
DateTime DateTime DateTime DateTime

要比较的第二个对象。The second object to compare.

返回

有符号数字,指示 t1t2 的相对值。A signed number indicating the relative values of t1 and t2.

值类型Value Type 条件Condition
小于零Less than zero t1 早于 t2t1 is earlier than t2.
Zero t1t2 相同。t1 is the same as t2.
大于零Greater than zero t1 晚于 t2t1 is later than t2.

示例

下面的示例演示 Compare 方法。The following example demonstrates the Compare method.

using System;

public class Example
{
   public static void Main()
   {
      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
Module Example
   Public Sub Main()
      Dim date1 As Date = #08/01/2009 12:00AM#
      Dim date2 As Date = #08/01/2009 12:00PM#
      Dim result As Integer = DateTime.Compare(date1, date2)
      Dim relationship As String
      
      If result < 0 Then
         relationship = "is earlier than"
      ElseIf result = 0 Then
         relationship = "is the same time as"         
      Else
         relationship = "is later than"
      End If
      
      Console.WriteLine("{0} {1} {2}", date1, relationship, date2)
   End Sub
End Module
' The example displays the following output:
'    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM

注解

若要确定 @no__t 0 与 t2 之间的关系,@no__t 2 方法会比较 @no__t 和 @no__t 的 Ticks 属性,但会忽略其 @no__t 属性。To determine the relationship of t1 to t2, the Compare method compares the Ticks property of t1 and t2 but ignores their Kind property. 在比较 DateTime 对象之前,请确保对象表示相同时区中的时间。Before comparing DateTime objects, ensure that the objects represent times in the same time zone.

适用于

另请参阅