Export (0) Print
Expand All

TimeSpan Less Than Or Equal Operator

Indicates whether a specified TimeSpan is less than or equal to another specified TimeSpan.

[Visual Basic]
returnValue = TimeSpan.op_LessThanOrEqual(t1, t2)
[C#]
public static bool operator <=(
 TimeSpan t1,
 TimeSpan t2
);
[C++]
public: static bool op_LessThanOrEqual(
 TimeSpan t1,
 TimeSpan t2
);
[JScript]
returnValue = t1 <= t2;

[Visual Basic] In Visual Basic, you can use the operators defined by a type, but you cannot define your own. You can use the Compare method instead of the TimeSpan less than or equal operator.

[JScript] In JScript, you can use the operators defined by a type, but you cannot define your own.

Arguments [Visual Basic, JScript]

t1
A TimeSpan.
t2
A TimeSpan.

Parameters [C#, C++]

t1
A TimeSpan.
t2
A TimeSpan.

Return Value

true if the value of t1 is less than or equal to the value of t2; otherwise, false.

Example

[Visual Basic, C#, C++] The following code example compares several TimeSpan objects to a reference TimeSpan using the LessThanOrEqual operator.

[Visual Basic] 
' Example of the TimeSpan relational operators.
Imports System
Imports Microsoft.VisualBasic

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

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

[C++] 
// Example of the TimeSpan relational operators.
#using <mscorlib.dll>
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 = new String( protoFmt );

    Console::WriteLine( );
    Console::WriteLine( dataFmt, 
        String::Concat( S"Right: ", RightText ), __box( Right ) );
    Console::WriteLine( dataFmt, S"Left == Right", 
        __box( Left == Right ) );
    Console::WriteLine( dataFmt, S"Left >  Right", 
        __box( Left > Right ) );
    Console::WriteLine( dataFmt, S"Left >= Right", 
        __box( Left >= Right ) );
    Console::WriteLine( dataFmt, S"Left != Right", 
        __box( Left != Right ) );
    Console::WriteLine( dataFmt, S"Left <  Right", 
        __box( Left < Right ) );
    Console::WriteLine( dataFmt, S"Left <= Right", 
        __box( Left <= Right ) );
}

void main( )
{
    TimeSpan Left = TimeSpan( 2, 0, 0 );

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

    // Create objects to compare with a 2-hour TimeSpan.
    CompareTimeSpans( Left, TimeSpan( 0, 120, 0 ), 
        S"TimeSpan( 0, 120, 0 )" );
    CompareTimeSpans( Left, TimeSpan( 2, 0, 1 ), 
        S"TimeSpan( 2, 0, 1 )" );
    CompareTimeSpans( Left, TimeSpan( 2, 0, -1 ), 
        S"TimeSpan( 2, 0, -1 )");
    CompareTimeSpans( Left, TimeSpan::FromDays( 1.0 / 12. ), 
        S"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
*/ 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

TimeSpan Structure | TimeSpan Members | System Namespace | Compare | CompareTo

Show:
© 2014 Microsoft