Equals Method (TimeSpan, TimeSpan)
Collapse the table of content
Expand the table of content

TimeSpan.Equals Method (TimeSpan, TimeSpan)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

public static bool Equals(
	TimeSpan t1,
	TimeSpan t2
)

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.
using System;

class Example
{
   const string dataFmt = "{0,-38}{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, "TimeSpan.Equals( Left, Right )",
          TimeSpan.Equals(Left, Right)) + "\n";
      outputBlock.Text += String.Format(dataFmt,
          "TimeSpan.Compare( Left, Right )",
          TimeSpan.Compare(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.Equals( TimeSpan, Time" +
          "Span ) and \nTimeSpan.Compare( TimeSpan, TimeSpan ) " +
          "methods generates the \nfollowing output by creating " +
          "several different TimeSpan \nobjects and comparing " +
          "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, new TimeSpan(72000000000),
          "TimeSpan( 72000000000 )");
      CompareTimeSpans(outputBlock, Left, TimeSpan.FromDays(1.0 / 12D),
          "TimeSpan.FromDays( 1 / 12 )");
   }
}

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


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2016 Microsoft