TimeSpan.LessThanOrEqual Operator

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Shared Operator <= ( _
    t1 As TimeSpan, _
    t2 As TimeSpan _
) As Boolean
public static bool operator <=(
    TimeSpan t1,
    TimeSpan t2
)

Parameters

Return Value

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

Examples

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

' Example of the TimeSpan relational operators.

Module Example

   Const dataFmt As String = "{0,-47}{1}"

   ' Compare TimeSpan parameters, and display them with the results.
   Sub CompareTimeSpans(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal Left As TimeSpan, ByVal Right As TimeSpan, _
       ByVal RightText As String)

      outputBlock.Text &= vbCrLf
      outputBlock.Text += String.Format(dataFmt, "Right: " & RightText, Right) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_Equality( Left, Right )", _
          TimeSpan.op_Equality(Left, Right)) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_GreaterThan( Left, Right )", _
          TimeSpan.op_GreaterThan(Left, Right)) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_GreaterThanOrEqual( Left, Right )", _
          TimeSpan.op_GreaterThanOrEqual(Left, Right)) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_Inequality( Left, Right )", _
          TimeSpan.op_Inequality(Left, Right)) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_LessThan( Left, Right )", _
          TimeSpan.op_LessThan(Left, Right)) & vbCrLf
      outputBlock.Text += String.Format(dataFmt, _
          "TimeSpan.op_LessThanOrEqual( Left, Right )", _
          TimeSpan.op_LessThanOrEqual(Left, Right)) & vbCrLf
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      Dim Left As New TimeSpan(2, 0, 0)

      outputBlock.Text += _
          "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 & vbCrLf
      outputBlock.Text += String.Format(dataFmt, "Left: TimeSpan( 2, 0, 0 )", Left) & vbCrLf

      ' Create objects to compare with a 2-hour TimeSpan.
      CompareTimeSpans(outputBlock, Left, New TimeSpan(0, 120, 0), _
          "TimeSpan( 0, 120, 0 )")
      CompareTimeSpans(outputBlock, Left, New TimeSpan(2, 0, 1), _
          "TimeSpan( 2, 0, 1 )")
      CompareTimeSpans(outputBlock, Left, New TimeSpan(2, 0, -1), _
          "TimeSpan( 2, 0, -1 )")
      CompareTimeSpans(outputBlock, 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
// Example of the TimeSpan relational operators.
using System;

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

   // Compare TimeSpan parameters, and display them with the results.
   static void CompareTimeSpans(System.Windows.Controls.TextBlock outputBlock, TimeSpan Left, TimeSpan Right,
       string RightText)
   {
      outputBlock.Text += "\n";
      outputBlock.Text += String.Format(dataFmt, "Right: " + RightText, Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left == Right", Left == Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left >  Right", Left > Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left >= Right", Left >= Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left != Right", Left != Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left <  Right", Left < Right) + "\n";
      outputBlock.Text += String.Format(dataFmt, "Left <= Right", Left <= Right) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      TimeSpan Left = new TimeSpan(2, 0, 0);

      outputBlock.Text += 
          "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\n";
      outputBlock.Text += String.Format(dataFmt,
          "Left: TimeSpan( 2, 0, 0 )", Left) + "\n";

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.