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

This unconstrained (value‐semantic) attribute class characterizes how to configure certain behavior in `Iso8601Util` functions. Currently, only the `generate` and `generateRaw` methods of that utility are affected by `Iso8601UtilConfiguration` settings. See the  section for information on the class attributes.

== Synopsis

Declared in `<bdlt_iso8601utilconfiguration.h>`

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

== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/2constructor-0b.adoc[`Iso8601UtilConfiguration`]         [.small]#[constructor]#
| Constructors
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/2destructor.adoc[`~Iso8601UtilConfiguration`] [.small]#[destructor]#
| Destroy this object.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/operator_assign.adoc[`operator=`] 
| Assign to this object the value of the specified `rhs` configuration, and return a reference providing modifiable access to this object.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/fractionalSecondPrecision.adoc[`fractionalSecondPrecision`] 
| Return the value of the `fractionalSecondPrecision` attribute of this object.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/omitColonInZoneDesignator.adoc[`omitColonInZoneDesignator`] 
| Return the value of the `omitColonInZoneDesignator` attribute of this object.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/print.adoc[`print`] 
| Write the value of this object to the specified output `stream` in a human‐readable format, and return a reference to `stream`. Optionally specify an initial indentation `level`, whose absolute value is incremented recursively for nested objects. If `level` is specified, optionally specify `spacesPerLevel`, whose absolute value indicates the number of spaces per indentation level for this and all of its nested objects. If `level` is negative, suppress indentation of the first line. If `spacesPerLevel` is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by `level`). If `stream` is not valid on entry, this operation has no effect. Note that this human‐readable format is not fully specified, and can change without notice.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/setFractionalSecondPrecision.adoc[`setFractionalSecondPrecision`] 
| Set the `fractionalSecondPrecision` attribute of this object to the specified `value`. The behavior is undefined unless `0 <= value` and `6 >= value`.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/setOmitColonInZoneDesignator.adoc[`setOmitColonInZoneDesignator`] 
| Set the `omitColonInZoneDesignator` attribute of this object to the specified `value`.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/setUseCommaForDecimalSign.adoc[`setUseCommaForDecimalSign`] 
| Set the `useCommaForDecimalSign` attribute of this object to the specified `value`.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/setUseZAbbreviationForUtc.adoc[`setUseZAbbreviationForUtc`] 
| Set the `useZAbbreviationForUtc` attribute of this object to the specified `value`.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/useCommaForDecimalSign.adoc[`useCommaForDecimalSign`] 
| Return the value of the `useCommaForDecimalSign` attribute of this object.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/useZAbbreviationForUtc.adoc[`useZAbbreviationForUtc`] 
| Return the value of the `useZAbbreviationForUtc` attribute of this object.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/defaultConfiguration.adoc[`defaultConfiguration`] 
| Return the value of the process‐wide `Iso8601UtilConfiguration` that is currently in effect.
| xref:BloombergLP/bdlt/Iso8601UtilConfiguration/setDefaultConfiguration.adoc[`setDefaultConfiguration`] 
| Set the value of the process‐wide `Iso8601UtilConfiguration` to the specified `configuration`. Note that the expected usage is that the process‐wide configuration will be established _once_, early in `main`, and not changed throughout the lifetime of a process.
|===


== Friends

[cols="1,4"]
|===
| Name| Description
| `xref:BloombergLP/bdlt/operator_not_eq-089.adoc[BloombergLP::bdlt::operator!=]`
| Return `true` if the specified `lhs` and `rhs` objects do not have the same value, and `false` otherwise. Two `Iso8601UtilConfiguration` objects do not have the same value if any of their `fractionalSecondPrecision`, `omitColonInZoneDesignator`, `useCommaForDecimalSign`, or `useZAbbreviationForUtc` attributes (respectively) do not have the same value.
| `xref:BloombergLP/bdlt/operator_eq-014.adoc[BloombergLP::bdlt::operator==]`
| Return `true` if the specified `lhs` and `rhs` objects have the same value, and `false` otherwise. Two `Iso8601UtilConfiguration` objects have the same value if each of their `fractionalSecondPrecision`, `omitColonInZoneDesignator`, `useCommaForDecimalSign`, and `useZAbbreviationForUtc` attributes (respectively) have the same value.
|===


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