[#BloombergLP-baltzo-TimeZoneUtilImp]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/baltzo.adoc[baltzo]::TimeZoneUtilImp
:relfileprefix: ../../
:mrdocs:

This `struct` provides a namespace for utility functions that convert time values to, and from, local time&period;

== Synopsis

Declared in `&lt;baltzo&lowbar;timezoneutilimp&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct TimeZoneUtilImp;
----

== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/baltzo/TimeZoneUtilImp/convertUtcToLocalTime.adoc[`convertUtcToLocalTime`] 
| Load, into the specified `result`, the local date&hyphen;time value, in the time zone indicated by the specified `resultTimeZoneId`, corresponding to the specified `utcTime`, using time zone information supplied by the specified `cache`&period; Return 0 on success, and a non&hyphen;zero value otherwise&period; A return status of `ErrorCode&colon;&colon;k&lowbar;UNSUPPORTED&lowbar;ID` indicates that `resultTimeZoneId` is not recognized, and a return status of `ErrorCode&colon;&colon;k&lowbar;OUT&lowbar;OF&lowbar;RANGE` indicates that an out of range value of `result` would have occurred&period;
| xref:BloombergLP/baltzo/TimeZoneUtilImp/createLocalTimePeriod.adoc[`createLocalTimePeriod`] 
| Load, into the specified `result`, attributes characterizing local time indicated by the specified `transition` in the specified `timeZone`&period; The behavior is undefined unless `ZoneinfoUtil&colon;&colon;isWellFormed(timeZone)` is `true` and `transition` is a valid, non&hyphen;ending, iterator into the sequence of transitions described by `timeZone`&period;
| xref:BloombergLP/baltzo/TimeZoneUtilImp/initLocalTime.adoc[`initLocalTime`] 
| Load, into the specified `result`, the local date&hyphen;time value &hyphen;&hyphen; including the local date, time, and resolved UTC offset &hyphen;&hyphen; indicated by the specified `localTime` in the time zone indicated by the specified `timeZoneId`, using the specified `dstPolicy` to interpret whether or not `localTime` represents a daylight&hyphen;saving time value, and using time zone information supplied by the specified `cache`&period; Load, into the specified `resultValidity` the value indicating the whether `localTime` is unique, ambiguous but valid, or invalid&period; Return 0 on success, and a non&hyphen;zero value otherwise&period; A return status of `ErrorCode&colon;&colon;k&lowbar;UNSUPPORTED&lowbar;ID` indicates that `timeZoneId` is not recognized&period; The behavior is undefined unless the result of the initialization falls within the supported epoch&period;
| xref:BloombergLP/baltzo/TimeZoneUtilImp/loadLocalTimePeriodForUtc.adoc[`loadLocalTimePeriodForUtc`] 
| Load, into the specified `result`, attributes characterizing local time at the specified `utcTime` in the time zone indicated by the specified `timeZoneId` (e&period;g&period;, the offset from UTC, whether it is daylight&hyphen;saving time), as well as the time interval over which those attributes apply, using time zone information supplied by the specified `cache`&period; Return 0 on success, and a non&hyphen;zero value otherwise&period; A return status of `ErrorCode&colon;&colon;k&lowbar;UNSUPPORTED&lowbar;ID` indicates that `timeZoneId` is not recognized&period;
| xref:BloombergLP/baltzo/TimeZoneUtilImp/resolveLocalTime.adoc[`resolveLocalTime`] 
| Load, into the specified `result`, the local time and UTC offset of the specified `localTime` in the specified `timeZone`, using the specified `dstPolicy` to interpret whether or not `localTime` represents a daylight&hyphen;saving time value&semi; load into the specified `resultValidity` an indication of whether `localTime` is valid and unique, valid but ambiguous, or invalid&semi; load into the specified `transitionIter` an iterator pointing to the transition that characterizes the attributes of `localTime`&period; The behavior is undefined unless `ZoneinfoUtil&colon;&colon;isWellFormed(timeZone)` is `true` and the result of the resolution falls within the supported epoch&period;
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#
