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

定義

2 つの TimeSpan 値を比較し、第 1 の値が第 2 の値よりも短いか、同じか、または長いかを示す整数を返します。Compares two TimeSpan values and returns an integer that indicates whether the first value is shorter than, equal to, or longer than the second value.

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

比較する最初の時間間隔。The first time interval to compare.

t2
TimeSpan

比較する 2 番目の時間間隔。The second time interval to compare.

戻り値

次のいずれかの値です。One of the following values.

[値]Value 説明Description
-1-1 t1t2 よりも短いです。t1 is shorter than t2.
00 t1t2 が等価です。t1 is equal to t2.
11 t1t2 よりも長いです。t1 is longer than t2.

次の例ではCompare 、メソッドを使用TimeSpanして、 TimeSpan 2 時間の時間間隔の値を持つオブジェクトと複数のオブジェクトを比較します。The following example uses the Compare method to compare several TimeSpan objects with a TimeSpan object whose value is a 2-hour time interval.

// 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

適用対象

こちらもご覧ください