DateTime.Compare(DateTime, DateTime) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

ソース:

DateTime.cs

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

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

比較する最初のオブジェクト。

t2

DateTime

比較する 2 番目のオブジェクト。

戻り値

Int32

t1 と t2 の相対値を示す符号付き数値。

値型	条件
0 より小さい値	t1 が t2 よりも前の日時です。
ゼロ	t1 は t2 と同じです。
0 より大きい値	t1 が t2 より後の日時です。

例

Compareメソッドの例を次に示します。

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 for en-us culture:
//    8/1/2009 12:00:00 AM is earlier than 8/1/2009 12:00:00 PM

let date1 = DateTime(2009, 8, 1, 0, 0, 0)
let date2 = DateTime(2009, 8, 1, 12, 0, 0)
let result = DateTime.Compare(date1, date2)

let relationship =
    if result < 0 then
        "is earlier than"
    elif result = 0 then
        "is the same time as"
    else
        "is later than"

printfn $"{date1} {relationship} {date2}"

// The example displays the following output for en-us culture:
//    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 の t2 プロパティt1をTicks比較しますが、そのプロパティはKind無視します。 オブジェクトを比較する DateTime 前に、オブジェクトが同じタイム ゾーンの時刻を表していることを確認します。

こちらもご覧ください

• CompareTo(Object)
• Equals(Object)