LeftDiff Method (TdPeriodTimestampWithTimeZone)

The period whose beginning and ending bounds are defined as the beginning bound of the operand and the beginning bound of the operand when the operands overlap.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Shared Function LeftDiff( _
   ByVal left As TdPeriodTimestampWithTimeZone, _
   ByVal right As TdPeriodTimestampWithTimeZone _
) As TdPeriodTimestampWithTimeZone

'Usage
 
Dim left As TdPeriodTimestampWithTimeZone
Dim right As TdPeriodTimestampWithTimeZone
Dim value As TdPeriodTimestampWithTimeZone
 
value = TdPeriodTimestampWithTimeZone.LeftDiff(left, right)

public static TdPeriodTimestampWithTimeZone LeftDiff( 
   TdPeriodTimestampWithTimeZone left,
   TdPeriodTimestampWithTimeZone right
)

public:
static TdPeriodTimestampWithTimeZone LeftDiff( 
   TdPeriodTimestampWithTimeZone left,
   TdPeriodTimestampWithTimeZone right
)

Parameters

left: The left TdPeriodTimestampWithTimeZone operand.
right: The right TdPeriodTimestampWithTimeZone operand.

Return Value

A TdPeriodTimestampWithTimeZone is returned that includes the portion of the left operand that exists before the beginning of the right operand when the operands overlap.

Remarks

It is required that the UTC Offset of both the left and right operand be the same.

A TdPeriodTimestampWithTimeZone.Null is returned under the following scenarios:

The left and right operands do not overlap.
The beginning bound of the left operand is less than the beginning bound of the right operand.
Either the left or right operand is null.

In the following examples the left and right operand are defined as (bL, eL) and (bR, eR), respectively.

Example	Comments
\|-------\|------\|------\| bL bR eL eR \|=======\|	Ldiff = (bL, bR)
\|------\|------\|-----\| bL bR eR eL \|======\|	Ldiff = (bL, bR)
\|-----\|-------\|-----\| bL eL bR eR	Ldiff = TdPeriodTimestampWithTimeZone.Null The left and right operands do not overlap.
\|------\|-----\|------\| bR bL eR eL	Ldiff = TdPeriodTimestampWithTimeZone.Null The beginning bound of the right operand is greater than the beginning bound of the left.
\|--------\|-------\| bL eL bR eR	Ldiff = TdPeriodTimestampWithTimeZone.Null The left and right operands do not overlap.
\|---------\|--------\| bL bR eR eL		Ldiff = TdPeriodTimestampWithTimeZone.Null The beginning bounds of both operands are equal. A period cannot be created whose beginning and ending bounds are equal.

Requirements

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

Reference

TdPeriodTimestampWithTimeZone Structure
TdPeriodTimestampWithTimeZone Members