TimeSpan.Compare Method (TimeSpan, TimeSpan)

 

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.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static int Compare(
	TimeSpan t1,
	TimeSpan t2
)

Parameters

t1
Type: System.TimeSpan

The first time interval to compare.

t2
Type: System.TimeSpan

The second time interval to compare.

Return Value

Type: System.Int32

One of the following values.

Value

Description

-1

t1 is shorter than t2.

0

t1 is equal to t2.

1

t1 is longer than t2.

The following example uses the Compare method to compare several TimeSpan objects with a TimeSpan object whose value is a 2-hour time interval.

using System;

class Example
{
    static void Main()
    {
        // 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 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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: