Load, into the specified result, the local date‐time value ‐‐ including the local date, time, and resolved UTC offset ‐‐ indicated by the specified localTime in the time zone indicated by the specified timeZoneId. Optionally specify resultValidity in which to load the validity of localTime as being unique, ambiguous but valid, or invalid. Optionally specify a dstPolicy indicating whether or not localTime represents a daylight‐saving time value. If dstPolicy is unspecified and localTime is a unique and valid time in the source time zone, then perform the conversion using that uniquely described time; if dstPolicy is unspecified and localTime is either ambiguous or invalid, then use the later of the two possible interpretations of localTime. The offset from UTC of the time zone is rounded down to minute precision. Return 0 on success, and a non‐zero value with no effect otherwise. A return value of ErrorCode::k_UNSUPPORTED_ID indicates that timeZoneId was not recognized. The behavior is undefined unless the result of the initialization falls within the supported epoch.

Synopsis

Declared in <baltzo_timezoneutil.h>

static
int
initLocalTime(
    bdlt::DatetimeTz* result,
    bdlt::Datetime const& localTime,
    char const* timeZoneId,
    DstPolicy::Enum dstPolicy = DstPolicy::e_UNSPECIFIED);

Created with MrDocs