std::time_get

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Localizations library

Locales and facets
locale
use_facet	has_facet
Character classification
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
Conversions
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
Facet category base classes
ctype_base codecvt_base messages_base	time_base money_base
Facet categories
ctype ctype<char> codecvt collate messages time_get time_put	num_get num_put numpunct money_get money_put moneypunct
Locale-specific facets
ctype_byname ctype_byname<char> codecvt_byname messages_byname collate_byname	time_get_byname time_put_byname numpunct_byname moneypunct_byname
Code conversion facets
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C locale
setlocale localeconv lconv	LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME

 

std::time_get

Member functions

time_get::time_get

time_get::~time_get

time_get::date_order time_get::do_date_order

time_get::get_time time_get::do_get_time

time_get::get_date time_get::do_get_date

time_get::get_weekday time_get::do_get_weekday

time_get::get_monthname time_get::do_get_monthname

time_get::get_year time_get::do_get_year

time_get::get time_get::do_get

 

Defined in header <locale>
template< class charT, class InputIterator = std::istreambuf_iterator<charT> > class time_get : public std::locale::facet, public std::time_base;

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.

Two specializations and two partial specializations are provided by the standard library and are implemented by all locale objects created in a C++ program:

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
std::time_get<char, InputIterator>	parses narrow string representations of date and time using custom input iterator
std::time_get<wchar_t, InputIterator>	parses wide string representations of date and time using custom input iterator

Member types

Member type	Definition
char_type	charT
iter_type	InputIterator

Member objects

Member name	Type
id (static)	std::locale::id

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	invokes do_get (public member function)

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]	extacts 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]	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

#include <iostream>
#include <sstream>
#include <string>
#include <locale>
#include <ctime>
#include <iomanip>
int main()
{
    std::wstring input = L"2011-Februar-18 23:12:34";
    std::tm t;
    std::wistringstream ss(input);
    ss.imbue(std::locale("de_DE"));
    ss >> std::get_time(&t, L"%Y-%b-%d %H:%M:%S"); // uses std::time_get<wchar_t>
    std::cout << std::asctime(&t);
}

Output:

Sun Feb 18 23:12:34 2011

See also

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