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

定義

2 つの TimeSpan 値を比較し、第 1 の値が第 2 の値よりも短いか、同じか、または長いかを示す整数を返します。

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

パラメーター

t1
TimeSpan

比較する最初の時間間隔。

t2
TimeSpan

比較する 2 番目の時間間隔。

戻り値

Int32

次のいずれかの値です。

[値] 説明
-1 t1t2 よりも短いです。
0 t1t2 が等価です。
1 t1t2 よりも長いです。

次の例では、メソッドを使用し Compare TimeSpan て、 TimeSpan 2 時間の時間間隔の値を持つオブジェクトと複数のオブジェクトを比較します。

// Define a time interval equal to two hours.
TimeSpan baseInterval = new TimeSpan( 2, 0, 0);

// Define an array of time intervals to compare with
// the base interval.
TimeSpan[] spans = { 
    TimeSpan.FromSeconds(-2.5),
    TimeSpan.FromMinutes(20),
    TimeSpan.FromHours(1), 
    TimeSpan.FromMinutes(90),
    baseInterval,  
    TimeSpan.FromDays(.5), 
    TimeSpan.FromDays(1) 
};

// Compare the time intervals.
foreach (var span in spans) {
   int result = TimeSpan.Compare(baseInterval, span);
   Console.WriteLine("{0} {1} {2} (Compare returns {3})", 
                     baseInterval,
                     result == 1 ? ">" : result == 0 ? "=" : "<",
                     span, result);     
}

// The example displays the following output:
//       02:00:00 > -00:00:02.5000000 (Compare returns 1)
//       02:00:00 > 00:20:00 (Compare returns 1)
//       02:00:00 > 01:00:00 (Compare returns 1)
//       02:00:00 > 01:30:00 (Compare returns 1)
//       02:00:00 = 02:00:00 (Compare returns 0)
//       02:00:00 < 12:00:00 (Compare returns -1)
//       02:00:00 < 1.00:00:00 (Compare returns -1)
Public Module Example
    Public Sub Main()
        ' Define a time interval equal to 2 hours.
        Dim baseInterval As New TimeSpan( 2, 0, 0)

        ' Define an array of time intervals to compare with  
        ' the base interval.
        Dim spans() As TimeSpan = { TimeSpan.FromSeconds(-2.5),
                                    TimeSpan.FromMinutes(20),
                                    TimeSpan.FromHours(1), 
                                    TimeSpan.FromMinutes(90),
                                    baseInterval,  
                                    TimeSpan.FromDays(.5), 
                                    TimeSpan.FromDays(1) }

        ' Compare the time intervals.
        For Each span In spans
           Dim result As Integer = TimeSpan.Compare(baseInterval, span)
           Console.WriteLine("{0} {1} {2} (Compare returns {3})", 
                             baseInterval,
                             If(result = 1, ">", If(result = 0, "=", "<")),
                             span, result)
        Next
    End Sub 
End Module 
' The example displays the following output:
'       02:00:00 > -00:00:02.5000000 (Compare return
'       02:00:00 > 00:20:00 (Compare returns 1
'       02:00:00 > 01:00:00 (Compare returns 1
'       02:00:00 > 01:30:00 (Compare returns 1
'       02:00:00 = 02:00:00 (Compare returns 0
'       02:00:00 < 12:00:00 (Compare returns -1
'       02:00:00 < 1.00:00:00 (Compare returns -1

適用対象

こちらもご覧ください