Export (0) Print
Expand All

TimeSpan.Equals Method (TimeSpan, TimeSpan)

Returns a value indicating whether two specified instances of TimeSpan are equal.

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

'Declaration
Public Shared Function Equals ( _
	t1 As TimeSpan, _
	t2 As TimeSpan _
) As Boolean

Parameters

t1
Type: System.TimeSpan
The first time interval to compare.
t2
Type: System.TimeSpan
The second time interval to compare.

Return Value

Type: System.Boolean
true if the values of t1 and t2 are equal; otherwise, false.

The following code example compares several TimeSpan objects to a reference TimeSpan object using the static Equals method.


' Example of the TimeSpan.Compare( TimeSpan, TimeSpan ) and 
' TimeSpan.Equals( TimeSpan, TimeSpan ) methods.

Module Example

   Const dataFmt As String = "{0,-38}{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.Equals( Left, Right ) & vbCrLf", _
          TimeSpan.Equals(Left, Right))
      outputBlock.Text &= String.Format(dataFmt, _
          "TimeSpan.Compare( Left, Right )", _
          TimeSpan.Compare(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.Equals( TimeSpan, " & _
          "TimeSpan ) and " & vbCrLf & "TimeSpan.Compare( " & _
          "TimeSpan, TimeSpan ) methods generates the " & vbCrLf & _
          "following output by creating several " & _
          "different TimeSpan " & vbCrLf & "objects and " & _
          "comparing 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, New TimeSpan(72000000000), _
          "TimeSpan( 72000000000 )")
      CompareTimeSpans(outputBlock, Left, TimeSpan.FromDays(1.0 / 12.0R), _
          "TimeSpan.FromDays( 1 / 12 )")
   End Sub
End Module

' This example of the TimeSpan.Equals( TimeSpan, TimeSpan ) and
' TimeSpan.Compare( TimeSpan, TimeSpan ) methods generates the
' following output by creating several different TimeSpan
' objects and comparing them with a 2-hour TimeSpan.
' 
' Left: TimeSpan( 2, 0, 0 )             02:00:00
' 
' Right: TimeSpan( 0, 120, 0 )          02:00:00
' TimeSpan.Equals( Left, Right )        True
' TimeSpan.Compare( Left, Right )       0
' 
' Right: TimeSpan( 2, 0, 1 )            02:00:01
' TimeSpan.Equals( Left, Right )        False
' TimeSpan.Compare( Left, Right )       -1
' 
' Right: TimeSpan( 2, 0, -1 )           01:59:59
' TimeSpan.Equals( Left, Right )        False
' TimeSpan.Compare( Left, Right )       1
' 
' Right: TimeSpan( 72000000000 )        02:00:00
' TimeSpan.Equals( Left, Right )        True
' TimeSpan.Compare( Left, Right )       0
' 
' Right: TimeSpan.FromDays( 1 / 12 )    02:00:00
' TimeSpan.Equals( Left, Right )        True
' TimeSpan.Compare( Left, Right )       0


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

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

Community Additions

ADD
Show:
© 2014 Microsoft