Equality Operator (TdPeriodTimestampWithTimeZone)

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

Syntax

Visual Basic
C#
C++/CLI

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

'Usage

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

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

Parameters

left: An instance of TdPeriodTimestampWithTimeZone.
right: An instance of TdPeriodTimestampWithTimeZone.

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 TdPeriodTimestampWithTimeZone.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 TdPeriodTimestampWithTimeZone.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. TdDate 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.

TdPeriodTimestampWithTimeZone x = TdPeriodTimestampWithTimeZone.Null;
TdPeriodTimestampWithTimeZone y = new TdPeriodTimestampWithTimeZone(
        new TdTimestampWithTimeZone(2008, 10, 10, 12, 10, 33, 0, new TimeSpan(8, 0, 0)), 
        new TdTimestampWithTimeZone(2008, 11, 30, 14, 11, 22, 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 = TdPeriodTimestampWithTimeZone.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

Product	Versions	Platforms
.NET	6, 7	Windows, Linux, MacOS
.NET Framework	4.6.2, 4.7, 4.7.1, 4.7.2, 4.8	Windows
.NET Standard	2.0	Windows, Linux, MacOS

Reference

TdPeriodTimestampWithTimeZone Structure
TdPeriodTimestampWithTimeZone Members