Convert utcTime to local time in targetTimeZoneId.

Synopsis

Declared in <baltzo_timezoneutil.h>

static
int
convertUtcToLocalTime(
    LocalDatetime* result,
    char const* targetTimeZoneId,
    bdlt::Datetime const& utcTime);

Description

Load, into the specified result, the local date‐time value (in the time zone indicated by the specified targetTimeZoneId) corresponding to the specified utcTime. 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 targetTimeZoneId was not recognized, and a return value of ErrorCode::k_OUT_OF_RANGE indicates that the result of the operation would have been outside the range of values representable by the result type.

Return Value

0 on success, and a non‐zero value otherwise

Parameters

Name

Description

result

receives the converted local date‐time

targetTimeZoneId

identifier of the destination time zone

utcTime

UTC date‐time to convert

Created with MrDocs