Load the transitions that apply to localTime in timeZone.

Synopsis

Declared in <baltzo_zoneinfoutil.h>

static
void
loadRelevantTransitions(
    Zoneinfo::TransitionConstIterator* firstResultTransition,
    Zoneinfo::TransitionConstIterator* secondResultTransition,
    LocalTimeValidity::Enum* resultValidity,
    bdlt::Datetime const& localTime,
    Zoneinfo const& timeZone);

Description

Load, into the specified firstResultTransition, an iterator referring to the transition describing the characteristics of local time in effect at the specified localTime in the specified timeZone; in instances where localTime is not both a unique and valid local time in timeZone, load, into the specified secondResultTransition, an iterator referring to a subsequent transition describing the alternative characteristics of local time that could also apply to localTime; finally load, into the specified resultValidity, the validity of localTime as being unique, ambiguous but valid, or invalid. If resultValidity is e_VALID_UNIQUE, then firstResultTransition and secondResultTransition will be loaded with the same transition, otherwise the returned transitions will be distinct with secondResultTransition referring to the transition immediately after firstResultTransition. The behavior is undefined unless isWellFormed(timeZone) is true, and firstResultTransition != secondResultTransition.

Parameters

Name

Description

firstResultTransition

receives the transition in effect

secondResultTransition

receives the alternative transition

resultValidity

receives uniqueness or validity of localTime

localTime

local date‐time whose transitions are requested

timeZone

time zone used to interpret localTime

Created with MrDocs