Equality Operator (TdPeriodTimeWithTimeZone)

Compares two TdPeriodTimeWithTimeZone structures to determine whether the is equal to the operand.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Operator =( _
   ByVal left As TdPeriodTimeWithTimeZone, _
   ByVal right As TdPeriodTimeWithTimeZone _
) As Boolean

'Usage

public bool operator ==( 
   TdPeriodTimeWithTimeZone left,
   TdPeriodTimeWithTimeZone right
)

public:
bool operator ==( 
   TdPeriodTimeWithTimeZone left,
   TdPeriodTimeWithTimeZone right
)

Parameters

left: An instance of TdPeriodTimeWithTimeZone.
right: An instance of TdPeriodTimeWithTimeZone.

Return Value

A boolean is returned that indicates the result of the comparison.

Remarks

The beginning and ending bounds between the left and right operands are compared to determine whether the two periods are equal. The two periods are equal if the following is true:

    left.Begin == right.Begin && left.End == right.Begin

The value returned is true if the left is equal to the right, false otherwise.

Return Value Description

Return Value	Description
`true`	left and right are TdPeriodTimeWithTimeZone.Null -or- left is equal to right.
`false`	left or right is Null -or- left is not equal to right.

true

left and right are TdPeriodTimeWithTimeZone.Null

-or-

left is equal to right.

false

left or right is Null

-or-

left is not equal to right.

Unlike comparison operators, Equality operators do not always return false when left and right operands are Null. Therefore the reverse condition can be considered true. TdTimeWithTimeZone implementation is very similar to the Nullable class in this regard.

Example

The following example shows that the Equality operator can safely be used in an if statement.

TdPeriodTimeWithTimeZone x = TdPeriodTimeWithTimeZone.Null;
TdPeriodTimeWithTimeZone y = new TdPeriodTimeWithTimeZone(
       new TdTimeWithTimeZone(10, 10, 10, 0, new Timespan(8, 0, 0)), 
       new TdTimeWithTimeZone(12, 11, 30, 0, new TimeSpan(8, 0, 0)));
            
if (x == y)
{
    // x is equal to y.
    Console.WriteLine(@"X is equal to Y").
}
else
{
    // x is not equal y
    Console.WriteLine(@"X is not equal to Y").
}
            
y = TdPeriodTimeWithTimeZone.Null;
            
if (x == y)
{
    // x is equal to y.
    Console.WriteLine(@"X is equal to Y").
}
else
{
    // x is not equal y
    Console.WriteLine(@"X is not equal to Y").
}

Requirements

Target Platforms: Windows 8.1, Windows 10, Windows Server 2012 R2, Windows Server 2016, Windows Server 2019

Reference

TdPeriodTimeWithTimeZone Structure
TdPeriodTimeWithTimeZone Members