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

定義

DateTime の 2 つのインスタンスを比較し、第 1 のインスタンスが第 2 のインスタンスよりも前か、同じか、それとも後かを示す整数を返します。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

比較する 2 番目のオブジェクト。The second object to compare.

戻り値

t1t2 の相対値を示す符号付き数値。A signed number indicating the relative values of t1 and t2.

値型Value Type 条件Condition
0 より小さい値Less than zero t1t2 よりも前の日時です。t1 is earlier than t2.
0Zero t1t2 と同じです。t1 is the same as t2.
0 より大きい値Greater than zero t1t2 より後の日時です。t1 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

注釈

関係を判断するt1t2Compareメソッドの比較、Ticksプロパティのt1t2は無視されますが、そのKindプロパティ。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.

適用対象

こちらもご覧ください