View source for cpp/locale/time put byname

{{cpp/title|time_put_byname}}
{{cpp/locale/navbar}}
{{dcl begin}}
{{dcl header|locale}}
{{dcl|1=
template<
    class CharT,
    class OutputIt = std::ostreambuf_iterator<CharT>
> class time_put_byname : public std::time_put<CharT, OutputIt>;
}}
{{dcl end}}

{{tt|std::time_put_byname}} is a {{lc|std::time_put}} facet which encapsulates time and date formatting rules of the locale specified at its construction.

===Specializations===
The standard library is guaranteed to provide every specialization that satisfies the following type requirements:
* {{tt|CharT}} is one of {{c/core|char}} and {{c/core|wchar_t}}, and
* {{tt|OutputIt}} must meet the requirements of {{named req|OutputIterator}}.

===Member types===
{{dsc begin}}
{{dsc hitem|Member type|Definition}}
{{dsc|{{tt|char_type}}|{{tt|CharT}}}}
{{dsc|{{tt|iter_type}}|{{tt|OutputIt}}}}
{{dsc end}}

===Member functions===
{{dsc begin}}
{{dsc inc|cpp/locale/byname/dsc constructor|time_put_byname}}
{{dsc inc|cpp/locale/byname/dsc destructor|time_put_byname}}
{{dsc end}}

{{include|cpp/locale/byname/constructor|time_put_byname}}
{{include|cpp/locale/byname/destructor|time_put_byname}}

{{cpp/locale/time_put/inherit}}

===Example===
{{example
|Prints current time using the "C" locale with the {{tt|time_put}} facet replaced by various {{tt|std::time_put_byname}} facets. The result shown was obtained using the clang compiler.
|code=
#include <codecvt>
#include <ctime>
#include <iomanip>
#include <iostream>
 
int main()
{
    std::time_t t = std::time(nullptr);
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv(std::cout.rdbuf());
    std::wostream out(&conv);
    
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("ja_JP.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
    
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("ru_RU.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
    
    out.imbue(std::locale(out.getloc(),
                          new std::time_put_byname<wchar_t>("sv_SE.utf8")));
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
}
|p=true
|output=
木曜日 2023年10月05日 19時44分51秒
Четверг Чт 05 окт 2023 19:44:51
torsdag tor  5 okt 2023 19:44:51
}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/locale/dsc time_put}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}