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

Write the ISO 8601 representation of the specified `object` to the specified `buffer` of the specified `bufferLength` (in bytes), truncating (if necessary) to `bufferLength`. Optionally specify a `configuration` to affect the format of the generated string. If `configuration` is not supplied, the process‐wide default value `Iso8601UtilConfiguration::defaultConfiguration()` is used. Return the number of characters in the formatted string before truncation (not counting a null terminator). If `bufferLength` indicates sufficient capacity, `buffer` is null terminated. The behavior is undefined unless `0 <= bufferLength`. Note that a buffer of size `k_MAX_STRLEN + 1` is large enough to hold any string generated by this component (counting a null terminator, if any).

== Synopsis

Declared in `<bdlt_iso8601util.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
generate(
    char* buffer,
    xref:BloombergLP/bdlt/Iso8601Util/ssize_t.adoc[ssize_t] bufferLength,
    xref:BloombergLP/bsls/TimeInterval.adoc[bsls::TimeInterval] const& object);
----


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