View source for cpp/locale/time put

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

Class template {{tt|std::time_put}} encapsulates date and time formatting rules. The I/O manipulator {{lc|std::put_time}} uses the {{tt|std::time_put}} facet of the I/O stream's locale to generate text representation of an {{lc|std::tm}} object.

{{inheritance diagram/std-time_put}}

If a {{tt|std::time_put}} specialization is not guaranteed to be provided by the standard library (see below), the behaviors of its {{lc|put()}} and {{lc|do_put()}} are not guaranteed as specified.

===Specializations===
The standard library is guaranteed to provide the following specializations (they are {{rlp|locale|required to be implemented by any locale object}}):
{{dsc begin}}
{{dsc header|locale}}
{{dsc|{{c/core|std::time_put<char>}}|creates narrow string representations of date and time}}
{{dsc|{{c/core|std::time_put<wchar_t>}}|creates wide string representations of date and time}}
{{dsc end}}

In addition, the standard library is also 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/time_put/dsc constructor}}
{{dsc inc|cpp/locale/time_put/dsc destructor}}
{{dsc inc|cpp/locale/time_put/dsc put}}
{{dsc end}}

===Member objects===
{{dsc begin}}
{{dsc mem obj|nolink=true|{{dsc small|static std::locale::id}} id|''id'' of the locale}}
{{dsc end}}

===Protected member functions===
{{dsc begin}}
{{dsc inc|cpp/locale/time_put/dsc do_put}}
{{dsc end}}

===Example===
{{example
|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("ja_JP.utf8"));
    
    // this I/O manipulator std::put_time uses std::time_put<wchar_t>
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
}
|output=
水曜日 2011年11月09日 12時32分05秒
}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/locale/dsc time_put_byname}}
{{dsc inc|cpp/locale/dsc time_get}}
{{dsc inc|cpp/io/manip/dsc put_time}}
{{dsc end}}

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