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

Format one recognized specifier from `*specInOut` into `*outIt`.

== Synopsis

Declared in `<bdlt_timezoneformatter.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class t_ITERATOR>
bool
formatNextSpecifier(
    bsl::basic_string_view<t_CHAR>* specInOut,
    t_ITERATOR* outIt,
    int offset) const;
----

== Description

If the first character of the specified `*specInOut` is recognized by this specifier formatter, use it to format the time zone indicated by the specified `offset` to `*outIt`, remove the character from `*specInOut`, and return `true`, otherwise return `false` with no modification to `*specInOut`.

== Return Value

`true` if a specifier was formatted

== Parameters

[cols="1,4"]
|===
| Name| Description
| *specInOut*
| remaining format specification
| *outIt*
| output iterator receiving formatted characters
| *offset*
| UTC offset in minutes
|===


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