class template
<locale>
std::time_put
template <class charT, class OutputIterator = ostreambuf_iterator<charT> > class time_put;
Facet to format dates and times
The time_put standard facet is used to format the date and time information contained in a tm structure into a sequence of characters.
The time_put class template has a protected destructor: Programs shall only construct objects of derived classes, or use those installed in locale objects (through use_facet).
All standard locale objects support at least the following facet instantiations of the time_put class template (as part of the time category):
| facets in locale objects | notes |
|---|
time_put<char> | narrow characters, for use with ostream iterators |
time_put<wchar_t> | wide characters, for use with wostream iterators |
Template parameters
- charT
- Character type: the type of the characters in the sequence to write.
Aliased as member char_type.
- OutputIterator
- Output iterator type that points to the elements in the character sequence to write.
Defaults to ostreambuf_iterator, which is an iterator that can be implicitly converted from basic_ostream objects.
Aliased as member iter_type.
Member types
| member type | definition | description |
|---|
| char_type | The first template parameter (charT) | Character type |
| iter_type | The second template parameter (OutputIterator) | Iterator type.
Defaults to ostreambuf_iterator<charT> |
Member constants
The class contains a public static constant of type locale::id that uniquely identifies facets with time_put semantics.
Public member functions
- (constructor)
- time_put constructor (public member function)
- put
- Write time and date (public member function)
Virtual protected member functionss
- do_put
- Write formatted time [virtual] (protected virtual member function)
- (destructor)
- time_put destructor (protected member function)
Specializations
At least the following specializations and partial specializations of this template are provided in all library implementations:
| specialization |
|---|
time_put<char> |
time_put<wchar_t> |
template <class OutputIterator> time_put<char,OutputIterator> |
template <class OutputIterator> time_put<wchar_t,OutputIterator> |
Where OutputIterator shall be a type that satisfies the requirements of an output iterator able to iterate over elements of the specified character type.