class template


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 objectsnotes
time_put<char>narrow characters, for use with ostream iterators
time_put<wchar_t>wide characters, for use with wostream iterators

Template parameters

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.

Member types

member typedefinitiondescription
char_typeThe first template parameter (charT)Character type
iter_typeThe 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

Virtual protected member functionss


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.