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

注釈

t1との関係t2を判断するためにCompare 、メソッドはTickst2t1プロパティを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.

適用対象

こちらもご覧ください