std::put_time

Cuando se utiliza en una expresión out << put_time(tmb, fmt), dado un tiempo de calendario tmb, convierte la información de fecha y hora a una cadena de caracteres de acuerdo al formato fmt, como si se aplicase std::strftime, std::wcsftime, o análogos (dependiendo de CharT), de acuerdo con la faceta std::time_put del locale actualmente imbuido en el flujo de salida out. Esta función se comporta como una función de la salida con formato.

[editar] Parámetros

[editar] Valor de retorno

Devuelve un objeto de tipo no especificado de tal manera que si out es el nombre de un flujo de salida de tipo std::basic_ostream<CharT, Traits>, entonces la expresión out << put_time(tmb, fmt) se comporta como si el siguiente código se ejecutara:

typedef std::ostreambuf_iterator<CharT, Traits> Iter;
typedef std::time_put<CharT, Iter> TimePut;
const TimePut& tp = std::use_facet<TimePut>(out.getloc());
const Iter end = tp.put(Iter(out.rdbuf()), out, out.fill(), tmb, fmt, fmt + Traits::length(fmt));
if (end.failed())
    out.setstate(std::ios_base::badbit);

[editar] Ejemplo

#include <iostream>
#include <iomanip>
#include <ctime>
int main()
{
    std::time_t t = std::time(NULL);
    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

[editar] Ver también