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

## 定義

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

#### 戻り値

`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 前に、オブジェクトが同じタイム ゾーンの時刻を表していることを確認します。