std::put_time

template< class CharT >
/*unspecified*/ put_time( const std::tm* tmb, const CharT* fmt );

При использовании в выражении out << put_time(tmb, fmt), преобразует информацию о дате и времени из заданного календарного времени tmb в строку символов в соответствии с строкой формата fmt, как если бы вызывались std::strftime, std::wcsftime, или аналогичная функция (в зависимости от CharT) в соответствии с std::time_put компонентом локалей, в настоящее время используемых в потоке вывода out.

Параметры

Строка формата

Строка формата состоит из нуля или более спецификаторов преобразования и обычных символов (кроме %). Все обычные символы, включая завершающий нулевой символ, копируются в выходную строку без изменений. Каждый спецификатор преобразования начинается с символа % , необязательно после которого следуют E или O модификатор (игнорируется, если не поддерживается локалью), за которым следует символ, определяющий поведение спецификатора. Доступны следующие спецификаторы формата:

Возвращаемое значение

Объект неопределённого типа, такой что

• если out является объектом типа std::basic_ostream<CharT, Traits>, выражение out << put_time(tmb, fmt)
  • имеет тип std::basic_ostream<CharT, Traits>&
  • имеет значение out
  • ведет себя так, как будто вызвало f(out, tmb, fmt)

где функция f определена как:

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, const std::tm* tmb, const CharT* fmt)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using TimePut = std::time_put<CharT, Iter>;
 
    const TimePut& tp = std::use_facet<TimePut>(str.getloc());
    const Iter end = tp.put(Iter(str.rdbuf()), str, str.fill(), tmb,
        fmt, fmt + Traits::length(fmt));
 
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

Пример

#include <ctime>
#include <iomanip>
#include <iostream>
 
int main()
{
    std::time_t t = std::time(nullptr);
    std::tm tm = *std::localtime(&t);
 
    std::cout.imbue(std::locale("ru_RU.utf8"));
    std::cout << "ru_RU: " << std::put_time(&tm, "%c %Z") << '\n';
 
    std::cout.imbue(std::locale("ja_JP.utf8"));
    std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << '\n';
}

ru_RU: Ср. 28 дек. 2011 10:21:16 EST
ja_JP: 2011年12月28日 10時21分16秒 EST

См. также