Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

TimeSpan.Compare Method

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

.NET Framework

Supported in: 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.