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

Parse the first `length` characters of ISO 8601 `string` as a `Date`.

== Synopsis

Declared in `<bdlt_iso8601util.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
parse(
    xref:BloombergLP/bdlt/Date.adoc[Date]* result,
    char const* string,
    xref:BloombergLP/bdlt/Iso8601Util/ssize_t.adoc[ssize_t] length,
    xref:BloombergLP/bdlt/Iso8601Util/ParseConfiguration.adoc[ParseConfiguration] configuration = ParseConfiguration());
----

== Description

Load the parsed value into the specified `result`, using the optionally specified `configuration`. Return 0 on success, and a non‐zero value (with no effect) otherwise. `string` is assumed to be of the form: ` Default: YYYY‐MM‐DD{(+|‐)hh{:}mm|Z} Basic: YYYYMMDD{(+|‐)hh{:}mm|Z} ` _Exactly_ `length` characters are parsed; parsing will fail if a proper prefix of `string` matches the expected format, but the entire `length` characters do not. If the optional zone designator is present in `string`, it is parsed but ignored. The behavior is undefined unless `0 <= length`.


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