[#BloombergLP-bdlt-Iso8601Util]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlt.adoc[bdlt]::Iso8601Util
:relfileprefix: ../../
:mrdocs:

This `struct` provides a namespace for a suite of pure functions that perform conversions between objects of `bdlt` vocabulary type and their ISO 8601 representations. Each `generate` and `generateRaw` method takes a `bdlt` object (of type `Date`, `DateTz`, `Time`, `TimeTz`, `Datetime`, or `DatetimeTz`) and outputs its corresponding ISO 8601 representation to a user‐supplied character buffer or `bsl::ostream`. The `parse` methods effect the opposite conversion in that they populate a `bdlt` object from the result of parsing an ISO 8601 representation.

== Synopsis

Declared in `<bdlt_iso8601util.h>`

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

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/Iso8601Util/Configuration.adoc[`Configuration`] 
| Alias for `Iso8601UtilConfiguration`.
| xref:BloombergLP/bdlt/Iso8601Util/DateOrDateTz.adoc[`DateOrDateTz`] 
| `DateOrDateTz` is a convenient alias for `bdlb::Variant2<Date, DateTz>`.
| xref:BloombergLP/bdlt/Iso8601Util/DatetimeOrDatetimeTz.adoc[`DatetimeOrDatetimeTz`] 
| `DatetimeOrDatetimeTz` is a convenient alias for `bdlb::Variant2<Datetime, DatetimeTz>`.
| xref:BloombergLP/bdlt/Iso8601Util/GenerateConfiguration.adoc[`GenerateConfiguration`] 
| Configuration for string generation.
| xref:BloombergLP/bdlt/Iso8601Util/ParseConfiguration.adoc[`ParseConfiguration`] 
| Configuration for string parsing.
| xref:BloombergLP/bdlt/Iso8601Util/TimeOrTimeTz.adoc[`TimeOrTimeTz`] 
| `TimeOrTimeTz` is a convenient alias for `bdlb::Variant2<Time, TimeTz>`.
| xref:BloombergLP/bdlt/Iso8601Util/ssize_t.adoc[`ssize_t`] 
| Signed size type used by this component.
|===


== Enums

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/Iso8601Util/_04enum.adoc[`Unnamed enum`] 
| Fixed buffer lengths for ISO 8601 string representations.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/Iso8601Util/generate-0624.adoc[`generate`] 
| `generate` overloads
| xref:BloombergLP/bdlt/Iso8601Util/generateRaw-0a7.adoc[`generateRaw`] 
| `generateRaw` overloads
| xref:BloombergLP/bdlt/Iso8601Util/parse-08a.adoc[`parse`] 
| `parse` overloads
| xref:BloombergLP/bdlt/Iso8601Util/parseRelaxed-0c.adoc[`parseRelaxed`] 
| `parseRelaxed` overloads
|===



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