TimeSpan.Equality(TimeSpan, TimeSpan) Operator

Definition

Indicates whether two TimeSpan instances are equal.

public:
 static bool operator ==(TimeSpan t1, TimeSpan t2);
public static bool operator == (TimeSpan t1, TimeSpan t2);
static member ( = ) : TimeSpan * TimeSpan -> bool
Public Shared Operator == (t1 As TimeSpan, t2 As TimeSpan) As Boolean

Parameters

t1
TimeSpan

The first time interval to compare.

t2
TimeSpan

The second time interval to compare.

Returns

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

Examples

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

// Example of the TimeSpan relational operators.
using namespace System;
const __wchar_t * protoFmt = L"{0,35}    {1}";

// Compare TimeSpan parameters, and display them with the results.
void CompareTimeSpans( TimeSpan Left, TimeSpan Right, String^ RightText )
{
   String^ dataFmt = gcnew String( protoFmt );
   Console::WriteLine();
   Console::WriteLine( dataFmt, String::Concat( "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 );
}

int main()
{
   TimeSpan Left = 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( gcnew String( protoFmt ), "Left: TimeSpan( 2, 0, 0 )", Left );
   
   // Create objects to compare with a 2-hour TimeSpan.
   CompareTimeSpans( Left, TimeSpan(0,120,0), "TimeSpan( 0, 120, 0 )" );
   CompareTimeSpans( Left, TimeSpan(2,0,1), "TimeSpan( 2, 0, 1 )" );
   CompareTimeSpans( Left, TimeSpan(2,0,-1), "TimeSpan( 2, 0, -1 )" );
   CompareTimeSpans( Left, TimeSpan::FromDays( 1.0 / 12. ), "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.
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.
open System

let dataPrint x y = printfn $"%34s{x}    {y}"

// Compare TimeSpan parameters, and display them with the results.
let compareTimeSpans (left: TimeSpan) (right: TimeSpan) rightText =
    printfn ""
    dataPrint ("Right: " + rightText) right
    dataPrint "Left == Right" (left = right)
    dataPrint "Left >  Right" (left > right)
    dataPrint "Left >= Right" (left >= right)
    dataPrint "Left != Right" (left <> right)
    dataPrint "Left <  Right" (left < right)
    dataPrint "Left <= Right" (left <= right)

let left = TimeSpan( 2, 0, 0 )

printfn "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"
dataPrint "Left: TimeSpan( 2, 0, 0 )" left

// Create objects to compare with a 2-hour TimeSpan.
compareTimeSpans left (TimeSpan(0, 120, 0)) "TimeSpan( 0, 120, 0 )"
compareTimeSpans left (TimeSpan(2, 0, 1)) "TimeSpan( 2, 0, 1 )"
compareTimeSpans left (TimeSpan(2, 0, -1)) "TimeSpan( 2, 0, -1 )"
compareTimeSpans left (TimeSpan.FromDays(1. / 12.)) "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.
Module TSRelationalOpsDemo
    
    Const dataFmt As String = "{0,-47}{1}"

    ' Compare TimeSpan parameters, and display them with the results.
    Sub CompareTimeSpans( Left As TimeSpan, Right As TimeSpan, _
        RightText As String )

        Console.WriteLine( )
        Console.WriteLine( dataFmt, "Right: " & RightText, Right )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_Equality( Left, Right )", _
            TimeSpan.op_Equality( Left, Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_GreaterThan( Left, Right )", _
            TimeSpan.op_GreaterThan( Left, Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_GreaterThanOrEqual( Left, Right )", _
            TimeSpan.op_GreaterThanOrEqual( Left, Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_Inequality( Left, Right )", _
            TimeSpan.op_Inequality( Left, Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_LessThan( Left, Right )", _
            TimeSpan.op_LessThan( Left, Right ) )
        Console.WriteLine( dataFmt, _
            "TimeSpan.op_LessThanOrEqual( Left, Right )", _
            TimeSpan.op_LessThanOrEqual( Left, Right ) )
    End Sub 
        
    Sub Main( )
        Dim Left As New TimeSpan( 2, 0, 0 )
            
        Console.WriteLine( _
            "This example of the TimeSpan relational operators " & _
            "generates " & vbCrLf & "the following output. It " & _
            "creates several different TimeSpan " & vbCrLf & _
            "objects and compares them with a 2-hour " & _
            "TimeSpan." & vbCrLf )
        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 )" )
    End Sub 
End Module 

' 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
' TimeSpan.op_Equality( Left, Right )            True
' TimeSpan.op_GreaterThan( Left, Right )         False
' TimeSpan.op_GreaterThanOrEqual( Left, Right )  True
' TimeSpan.op_Inequality( Left, Right )          False
' TimeSpan.op_LessThan( Left, Right )            False
' TimeSpan.op_LessThanOrEqual( Left, Right )     True
' 
' Right: TimeSpan( 2, 0, 1 )                     02:00:01
' TimeSpan.op_Equality( Left, Right )            False
' TimeSpan.op_GreaterThan( Left, Right )         False
' TimeSpan.op_GreaterThanOrEqual( Left, Right )  False
' TimeSpan.op_Inequality( Left, Right )          True
' TimeSpan.op_LessThan( Left, Right )            True
' TimeSpan.op_LessThanOrEqual( Left, Right )     True
' 
' Right: TimeSpan( 2, 0, -1 )                    01:59:59
' TimeSpan.op_Equality( Left, Right )            False
' TimeSpan.op_GreaterThan( Left, Right )         True
' TimeSpan.op_GreaterThanOrEqual( Left, Right )  True
' TimeSpan.op_Inequality( Left, Right )          True
' TimeSpan.op_LessThan( Left, Right )            False
' TimeSpan.op_LessThanOrEqual( Left, Right )     False
' 
' Right: TimeSpan.FromDays( 1 / 12 )             02:00:00
' TimeSpan.op_Equality( Left, Right )            True
' TimeSpan.op_GreaterThan( Left, Right )         False
' TimeSpan.op_GreaterThanOrEqual( Left, Right )  True
' TimeSpan.op_Inequality( Left, Right )          False
' TimeSpan.op_LessThan( Left, Right )            False
' TimeSpan.op_LessThanOrEqual( Left, Right )     True

Remarks

The equivalent method for this operator is TimeSpan.Equals(Object)

Applies to

See also