# std::time_get

From cppreference.com
< cpp‎ | locale

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

### Type requirements

- `InputIt` must meet the requirements of LegacyInputIterator.

### Specializations

Two standalone (locale-independent) full specializations and two partial specializations are provided by the standard library:

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

In addition, every locale object constructed in a C++ program implements its own (locale-specific) versions of these specializations.

### 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] | 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] (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

Run this code

    #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)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/locale/time_get&oldid=103586"