This topic has not yet been rated - Rate this topic

TimeSpan.op_Equality Method

.NET Framework 2.0

Indicates whether two TimeSpan instances are equal.

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

public static bool operator == (
	TimeSpan t1,
	TimeSpan t2
)

J# does not support overloaded operators.

JScript

JScript supports the use of overloaded operators, but not the declaration of new ones.

Parameters

t1: A TimeSpan.

t2: A TimeSpan.

Return Value

true if the values of t1 and t2 are equal; otherwise, false.

Example

The following code example compares several TimeSpan objects to a reference TimeSpan using the Equality operator.

C++

// Example of the TimeSpan relational operators.
using System;

class TSRelationalOpsDemo
{
    const string dataFmt = "{0,34}    {1}" ;

    // Compare TimeSpan parameters, and display them with the results.
    static void CompareTimeSpans( TimeSpan Left, TimeSpan Right, 
        string RightText )
    {
        Console.WriteLine( );
        Console.WriteLine( dataFmt, "Right: " + RightText, Right );
        Console.WriteLine( dataFmt, "Left == Right", Left == Right );
        Console.WriteLine( dataFmt, "Left >  Right", Left > Right );
        Console.WriteLine( dataFmt, "Left >= Right", Left >= Right );
        Console.WriteLine( dataFmt, "Left != Right", Left != Right );
        Console.WriteLine( dataFmt, "Left <  Right", Left < Right );
        Console.WriteLine( dataFmt, "Left <= Right", Left <= Right );
    }

    static void Main( )
    {
        TimeSpan Left = new TimeSpan( 2, 0, 0 );

        Console.WriteLine(
            "This example of the TimeSpan relational operators " +
            "generates \nthe following output. It creates several " +
            "different TimeSpan \nobjects and compares them with " +
            "a 2-hour TimeSpan.\n" );
        Console.WriteLine( dataFmt, 
            "Left: TimeSpan( 2, 0, 0 )", Left );

        // Create objects to compare with a 2-hour TimeSpan.
        CompareTimeSpans( Left, new TimeSpan( 0, 120, 0 ), 
            "TimeSpan( 0, 120, 0 )" );
        CompareTimeSpans( Left, new TimeSpan( 2, 0, 1 ), 
            "TimeSpan( 2, 0, 1 )" );
        CompareTimeSpans( Left, new TimeSpan( 2, 0, -1 ), 
            "TimeSpan( 2, 0, -1 )" );
        CompareTimeSpans( Left, TimeSpan.FromDays( 1.0 / 12D ), 
            "TimeSpan.FromDays( 1 / 12 )" );
    } 
} 

/*
This example of the TimeSpan relational operators generates
the following output. It creates several different TimeSpan
objects and compares them with a 2-hour TimeSpan.

         Left: TimeSpan( 2, 0, 0 )    02:00:00

      Right: TimeSpan( 0, 120, 0 )    02:00:00
                     Left == Right    True
                     Left >  Right    False
                     Left >= Right    True
                     Left != Right    False
                     Left <  Right    False
                     Left <= Right    True

        Right: TimeSpan( 2, 0, 1 )    02:00:01
                     Left == Right    False
                     Left >  Right    False
                     Left >= Right    False
                     Left != Right    True
                     Left <  Right    True
                     Left <= Right    True

       Right: TimeSpan( 2, 0, -1 )    01:59:59
                     Left == Right    False
                     Left >  Right    True
                     Left >= Right    True
                     Left != Right    True
                     Left <  Right    False
                     Left <= Right    False

Right: TimeSpan.FromDays( 1 / 12 )    02:00:00
                     Left == Right    True
                     Left >  Right    False
                     Left >= Right    True
                     Left != Right    False
                     Left <  Right    False
                     Left <= Right    True
*/

// Example of the TimeSpan relational operators.
import System.*;

class TSRelationalOpsDemo
{
    private static String dataFmt = "{0,34}    {1}";

    // Compare TimeSpan parameters, and display them with the results.
    static void CompareTimeSpans(TimeSpan left, TimeSpan right,
            String rightText)
    {
        Console.WriteLine();
        Console.WriteLine(dataFmt, "Right: " + rightText, right);
        Console.WriteLine(dataFmt, "Left == Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) == 0)).toString());
        Console.WriteLine(dataFmt, "Left >  Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) > 0)).toString());
        Console.WriteLine(dataFmt, "Left >= Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) >= 0)).toString());
        Console.WriteLine(dataFmt, "Left != Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) != 0)).toString());
        Console.WriteLine(dataFmt, "Left <  Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) < 0)).toString());
        Console.WriteLine(dataFmt, "Left <= Right", ((System.Boolean)
            Convert.ToBoolean((left.CompareTo(right)) <= 0)).toString());
    } //CompareTimeSpans

    public static void main(String[] args)
    {
        TimeSpan left = new TimeSpan(2, 0, 0);

        Console.WriteLine(("This example of the TimeSpan relational operators"
            + "generates \nthe following output. It creates several "
            + "different TimeSpan \nobjects and compares them with " 
            +    "a 2-hour TimeSpan.\n"));
        Console.WriteLine(dataFmt, "left: TimeSpan( 2, 0, 0 )", left);

        // Create objects to compare with a 2-hour TimeSpan.
        CompareTimeSpans(left, new TimeSpan(0, 120, 0),
            "TimeSpan( 0, 120, 0 )");
        CompareTimeSpans(left, new TimeSpan(2, 0, 1), 
            "TimeSpan( 2, 0, 1 )");
        CompareTimeSpans(left, new TimeSpan(2, 0, -1),
            "TimeSpan( 2, 0, -1 )");
        CompareTimeSpans(left, TimeSpan.FromDays((1.0 / 12.0)), 
            "TimeSpan.FromDays( 1 / 12 )");
    } //main
} //TSRelationalOpsDemo

/*
This example of the TimeSpan relational operators generates
the following output. It creates several different TimeSpan
objects and compares them with a 2-hour TimeSpan.

         left: TimeSpan( 2, 0, 0 )    02:00:00

      right: TimeSpan( 0, 120, 0 )    02:00:00
                     left == right    True
                     left >  right    False
                     left >= right    True
                     left != right    False
                     left <  right    False
                     left <= right    True

        right: TimeSpan( 2, 0, 1 )    02:00:01
                     left == right    False
                     left >  right    False
                     left >= right    False
                     left != right    True
                     left <  right    True
                     left <= right    True

       right: TimeSpan( 2, 0, -1 )    01:59:59
                     left == right    False
                     left >  right    True
                     left >= right    True
                     left != right    True
                     left <  right    False
                     left <= right    False

right: TimeSpan.FromDays( 1 / 12 )    02:00:00
                     left == right    True
                     left >  right    False
                     left >= right    True
                     left != right    False
                     left <  right    False
                     left <= right    True
*/

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

TimeSpan Structure
TimeSpan Members
System Namespace
Equals
Compare
CompareTo

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD