Namespaces
Variants
Views
Actions

std::time_get

From cppreference.com
< cpp‎ | locale
Revision as of 18:53, 2 November 2012 by P12bot (Talk | contribs)

 
 
 
 

Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <locale>
</td>

<td></td> <td></td> <tr class="t-dcl-sep"><td></td><td></td><td></td></tr>

<tr class="t-dcl ">

<td class="t-dcl-nopad">
template<

    class CharT,
    class InputIt = std::istreambuf_iterator<CharT>

> class time_get;
</td>

<td class="t-dcl-nopad"> </td> <td class="t-dcl-nopad"> </td> </tr> Template:ddcl list end

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.

cpp/locale/time basecpp/locale/locale/facetstd-time get-inheritance.svg
About this image

Inheritance diagram

Contents

Type requirements

-
InputIt must meet the requirements of InputIterator.

Specializations

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, 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

Member types

Member type Definition
char_type CharT
iter_type InputIt

Member functions

Template:cpp/locale/time get/dcl list date orderTemplate:cpp/locale/time get/dcl list get timeTemplate:cpp/locale/time get/dcl list get dateTemplate:cpp/locale/time get/dcl list get weekdayTemplate:cpp/locale/time get/dcl list get monthnameTemplate:cpp/locale/time get/dcl list get yearTemplate:cpp/locale/time get/dcl list get
constructs a new time_get facet
(public member function)
destructs a time_get facet
(protected member function)

Member objects

static std::locale::id id
id of the locale
(public member object)

Protected member functions

Template:cpp/locale/time get/dcl list do date orderTemplate:cpp/locale/time get/dcl list do get timeTemplate:cpp/locale/time get/dcl list do get dateTemplate:cpp/locale/time get/dcl list do get weekdayTemplate:cpp/locale/time get/dcl list do get monthnameTemplate:cpp/locale/time get/dcl list do get yearTemplate:cpp/locale/time get/dcl list do get

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

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