std::time_get

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Execution support library (C++26)

Technical specifications

Symbols index

External libraries

 

Localization library

Locales and facets
Locales
has_facet use_facet	locale
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
ctype facets
ctype ctype<char> ctype_byname	codecvt codecvt_byname
numeric facets
num_get num_put	numpunct numpunct_byname
collate facets
collate	collate_byname
time facets
time_get time_put	time_get_byname time_put_byname
monetary facets
money_get money_put	moneypunct moneypunct_byname
messages facets
messages	messages_byname

Character classification and conversion
Character classification
isspace isblank (C++11) iscntrl	isupper islower isalpha	ispunct isdigit isxdigit	isalnum isprint isgraph

Character conversions

toupper

tolower

String and stream conversions

wstring_convert (C++11/17/26*)

wbuffer_convert (C++11/17/26*)

Text encoding identifications

text_encoding (C++26)

Unicode conversion facets

codecvt_utf8 (C++11/17/26*)

codecvt_utf16 (C++11/17/26*)

codecvt_utf8_utf16 (C++11/17/26*)

codecvt_mode (C++11/17/26*)

C library locales
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::time_get

Member functions

time_get::time_get

time_get::~time_get

time_get::date_ordertime_get::do_date_order

time_get::get_timetime_get::do_get_time

time_get::get_datetime_get::do_get_date

time_get::get_weekdaytime_get::do_get_weekday

time_get::get_monthnametime_get::do_get_monthname

time_get::get_yeartime_get::do_get_year

time_get::gettime_get::do_get

 

Defined in header <locale>
template<     class CharT,     class InputIt = std::istreambuf_iterator<CharT> > class time_get;

Class template std::time_get encapsulates date and time parsing rules. The I/O manipulator std::get_time uses the std::time_get facet of the I/O stream's locale to convert text input to a std::tm object.

Inheritance diagram

If a std::time_get specialization is not guaranteed to be provided by the standard library (see below), the behaviors of its member functions (except the constructor and destructor) are not guaranteed as specified.

Specializations

The standard library is guaranteed to provide the following specializations (they are required to be implemented by any locale object):

Defined in header <locale>
std::time_get<char>	parses narrow string representations of date and time
std::time_get<wchar_t>	parses wide string representations of date and time

In addition, the standard library is also guaranteed to provide every specialization that satisfies the following type requirements:

• CharT is one of char and wchar_t, and
• InputIt must meet the requirements of LegacyInputIterator.

Member types

Member type	Definition
char_type	CharT
iter_type	InputIt

Member functions

(constructor)	constructs a new time_get facet (public member function)
(destructor)	destructs a time_get facet (protected member function)
date_order	invokes do_date_order (public member function)
get_time	invokes do_get_time (public member function)
get_date	invokes do_get_date (public member function)
get_weekday	invokes do_get_weekday (public member function)
get_monthname	invokes do_get_monthname (public member function)
get_year	invokes do_get_year (public member function)
get (C++11)	invokes do_get (public member function)

Member objects

static std::locale::id id

id of the locale (public member object)

Protected member functions

do_date_order [virtual]	obtains preferred ordering of day, month, and year (virtual protected member function)
do_get_time [virtual]	extracts hours, minutes, and seconds from input stream (virtual protected member function)
do_get_date [virtual]	extracts month, day, and year from input stream (virtual protected member function)
do_get_weekday [virtual]	extracts the name of a day of the week from input stream (virtual protected member function)
do_get_monthname [virtual]	extracts a month name from input stream (virtual protected member function)
do_get_year [virtual]	extracts a year from input stream (virtual protected member function)
do_get [virtual] (C++11)	extracts date/time components from input stream, according to the specified format (virtual protected member function)

Inherited from std::time_base

Type	Definition
dateorder	date order enumeration type, defining the values no_order, dmy, mdy, ymd, and ydm

Example

Note: choose clang to observe the output. libstdc++ does not correctly implement the %b specifier: bug 78714.

Run this code

#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';
}

Possible output:

Sun Feb 18 23:12:34 2011

See also

time_put	formats contents of std::tm for output as character sequence (class template)
get_time (C++11)	parses a date/time value of specified format (function template)