TimeSpan.Equality(TimeSpan, TimeSpan) Operator
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Indicates whether two TimeSpan instances are equal.
public:
static bool operator ==(TimeSpan t1, TimeSpan t2);C#
public static bool operator ==(TimeSpan t1, TimeSpan t2);static member ( = ) : TimeSpan * TimeSpan -> boolPublic Shared Operator == (t1 As TimeSpan, t2 As TimeSpan) As Boolean- t1
- TimeSpan
The first time interval to compare.
- t2
- TimeSpan
The second time interval to compare.
true if the values of t1 and t2 are equal; otherwise, false.
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
*/
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.
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
The equivalent method for this operator is TimeSpan.Equals(Object)
| Product | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
.NET feedback
.NET is an open source project. Select a link to provide feedback: