std:: get_time

When used in an expression in >> get_time ( tmb, fmt ) , parses the character input as a date/time value according to format string fmt according to the std::time_get facet of the locale currently imbued in the input stream in . The resultant value is stored in a std::tm object pointed to by tmb .

Parameters

Return value

An object of unspecified type such that

• if in is an object of type std:: basic_istream < CharT, Traits > , the expression in >> get_time ( tmb, fmt )
  • has type std:: basic_istream < CharT, Traits > &
  • has value in
  • behaves as if it called f ( in, tmb, fmt )

where the function f is defined as:

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, std::tm* tmb, const CharT* fmt)
{
    using Iter = std::istreambuf_iterator<CharT, Traits>;
    using TimeGet = time_get<CharT, Iter>;
 
    std::ios_base::iostate err = std::ios_base::goodbit;
    const TimeGet& tg = std::use_facet<TimeGet>(str.getloc());
 
    tg.get(Iter(str.rdbuf()), Iter(), str, err, tmb,
        fmt, fmt + Traits::length(fmt));
 
    if (err != std::ios_base::goodbit)
        str.setstate(err);
}

Notes

As specified in std::time_get::do_get , which this function calls, it's unspecified if this function zero out the fields in * tmb that are not set directly by the conversion specifiers that appear in fmt : portable programs should initialize every field of * tmb to zero before calling std::get_time .

Example

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
 
int main()
{
    std::tm t = {};
    std::istringstream ss("2011-Februar-18 23:12:34");
    ss.imbue(std::locale("de_DE.utf-8"));
    ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
 
    if (ss.fail())
        std::cout << "Parse failed\n";
    else
        std::cout << std::put_time(&t, "%c") << '\n';
}

Sun Feb 18 23:12:34 2011

See also