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|
|narrow characters, for use with ostream iterators|
|wide characters, for use with wostream iterators|
- Character type: the type of the characters in the sequence to write.
Aliased as member char_type.
- 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.
|char_type||The first template parameter (charT)||Character type|
|iter_type||The second template parameter (OutputIterator)||Iterator type.|
The class contains a public static constant of type locale::id that uniquely identifies facets with time_put semantics.
Public member functions
- time_put constructor (public member function)
- Write time and date (public member function)
Virtual protected member functionss
- Write formatted time [virtual] (protected virtual member function)
- time_put destructor (protected member function)
At least the following specializations and partial specializations of this template are provided in all library implementations:
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.