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

This value‐semantic type holds Zoneinfo (or "Olson") time‐zone data for a single locale.

== Synopsis

Declared in `<baltzo_zoneinfo.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
class Zoneinfo;
----

== Description

This class is a value‐semantic type holding a structured representation of the information contained in an Zoneinfo (or "Olson") time zone database for a _single_ locale (e.g., "America/New_York"). The salient attributes of this type are the string identifier and the ordered sequence of `ZoneinfoTransition` objects.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/baltzo/Zoneinfo/TransitionConstIterator.adoc[`TransitionConstIterator`] 
| Alias for a bi‐directional `const` iterator over the sequence of transitions maintained by a `Zoneinfo` object.
| xref:BloombergLP/baltzo/Zoneinfo/allocator_type.adoc[`allocator_type`] 
| Allocator type used by this class.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/baltzo/Zoneinfo/2constructor-002.adoc[`Zoneinfo`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/baltzo/Zoneinfo/operator_assign-0b.adoc[`operator=`] 
| Assignment operators
| xref:BloombergLP/baltzo/Zoneinfo/addTransition.adoc[`addTransition`] 
| Add a transition at the specified `utcTime` with the specified `descriptor`.
| xref:BloombergLP/baltzo/Zoneinfo/allocator.adoc[`allocator`] 
| Return `get_allocator().mechanism()`.
| xref:BloombergLP/baltzo/Zoneinfo/beginTransitions.adoc[`beginTransitions`] 
| Return an iterator providing non‐modifiable access to the first transition in the ordered sequence of transitions maintained by this object.
| xref:BloombergLP/baltzo/Zoneinfo/endTransitions.adoc[`endTransitions`] 
| Return an iterator providing non‐modifiable access to one past the last transition in the ordered sequence of transitions associated with this object.
| xref:BloombergLP/baltzo/Zoneinfo/findTransitionForUtcTime.adoc[`findTransitionForUtcTime`] 
| Return an iterator providing non‐modifiable access to the transition that holds the local‐time descriptor associated with the specified `utcTime`.
| xref:BloombergLP/baltzo/Zoneinfo/firstTransition.adoc[`firstTransition`] 
| Return a reference providing non‐modifiable access to the first transition contained in this object. The behavior is undefined unless `numTransitions() > 0`.
| xref:BloombergLP/baltzo/Zoneinfo/get_allocator.adoc[`get_allocator`] 
| Return the allocator used by this object to supply memory.
| xref:BloombergLP/baltzo/Zoneinfo/identifier.adoc[`identifier`] 
| Return a reference providing non‐modifiable access to the `identifier` attribute of this object.
| xref:BloombergLP/baltzo/Zoneinfo/numTransitions.adoc[`numTransitions`] 
| Return the number of transitions maintained by this zone info.
| xref:BloombergLP/baltzo/Zoneinfo/posixExtendedRangeDescription.adoc[`posixExtendedRangeDescription`] 
| Return a reference providing non‐modifiable access to the `posixExtendedRangeDescription` attribute of this object.
| xref:BloombergLP/baltzo/Zoneinfo/print.adoc[`print`] 
| Write the value of this object to the specified output `stream`.
| xref:BloombergLP/baltzo/Zoneinfo/setIdentifier-0b.adoc[`setIdentifier`] 
| `setIdentifier` overloads
| xref:BloombergLP/baltzo/Zoneinfo/setPosixExtendedRangeDescription-06.adoc[`setPosixExtendedRangeDescription`] 
| `setPosixExtendedRangeDescription` overloads
| xref:BloombergLP/baltzo/Zoneinfo/swap.adoc[`swap`] 
| Efficiently exchange the value of this object with the value of the specified `other` object.
| xref:BloombergLP/baltzo/Zoneinfo/2conversion.adoc[`operator BloombergLP::bslmf::NestedTraitDeclaration<Zoneinfo, UsesBslmaAllocator>`] 
| Nested trait declaration for `bslma::UsesBslmaAllocator`.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/baltzo/operator_eq-0c.adoc[BloombergLP::baltzo::operator==]`
| Return `true` if the specified `lhs` and `rhs` objects have the same value, and `false` otherwise.
|===

== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/baltzo/operator_not_eq-03.adoc[`operator!=`]
| Return `true` if the specified `lhs` and `rhs` objects do not have the same value, and `false` otherwise.
| xref:BloombergLP/baltzo/swap-096.adoc[`swap`]
| Exchange the values of the specified `a` and `b` objects.
|===


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