Difference between revisions of "cpp/locale/time get"

Revision as of 10:46, 12 October 2012

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

<td>

Defined in header <locale>

</td>

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.

Inheritance diagram

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

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

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

@@ Line 42: / Line 42: @@
 {{dcl list mem ctor | cpp/locale/time_get/time_get | constructs a new time_get facet }}
 {{dcl list prot mem dtor | cpp/locale/time_get/~time_get | destructs a time_get facet }}
-{{dcl list mem fun | cpp/locale/time_get/do_date_order | title=date_order | invokes {{tt|do_date_order}} }}
+{{dcl list mem fun | cpp/locale/time_get/date_order | invokes {{tt|do_date_order}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get_time | title=get_time | invokes {{tt|do_get_time}} }}
+{{dcl list mem fun | cpp/locale/time_get/get_time | invokes {{tt|do_get_time}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get_date | title=get_date | invokes {{tt|do_get_date}} }}
+{{dcl list mem fun | cpp/locale/time_get/get_date | invokes {{tt|do_get_date}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get_weekday | title=get_weekday | invokes {{tt|do_get_weekday}} }}
+{{dcl list mem fun | cpp/locale/time_get/get_weekday | invokes {{tt|do_get_weekday}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get_monthname | title=get_monthname | invokes {{tt|do_get_monthname}} }}
+{{dcl list mem fun | cpp/locale/time_get/get_monthname | invokes {{tt|do_get_monthname}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get_year | title=get_year | invokes {{tt|do_get_year}} }}
+{{dcl list mem fun | cpp/locale/time_get/get_year | invokes {{tt|do_get_year}} }}
-{{dcl list mem fun | cpp/locale/time_get/do_get | title=get | invokes {{tt|do_get}} }}
+{{dcl list mem fun | cpp/locale/time_get/get | invokes {{tt|do_get}} }}
 {{dcl list end}}
@@ Line 58: / Line 58: @@
 ===Protected member functions===
 {{dcl list begin}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_date_order  | obtains preferred ordering of day, month, and year}}
+{{dcl list prot mem vfun | cpp/locale/time_get/date_order | title=do_date_order| obtains preferred ordering of day, month, and year}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get_time  | extracts hours, minutes, and seconds from input stream}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get_time | title=do_get_time | extracts hours, minutes, and seconds from input stream}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get_date  | extracts month, day, and year from input stream}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get_date | title=do_get_date  | extracts month, day, and year from input stream}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get_weekday  | extracts the name of a day of the week from input stream}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get_weekday | title=do_get_weekday | extracts the name of a day of the week from input stream}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get_monthname  | extacts a month name from input stream}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get_monthname | title=do_get_monthname | extacts a month name from input stream}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get_year  | extracts a year from input stream}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get_year | title=do_get_year | extracts a year from input stream}}
-{{dcl list prot mem vfun | cpp/locale/time_get/do_get  | extracts date/time components from input stream, according to the specified format}}
+{{dcl list prot mem vfun | cpp/locale/time_get/get | title=do_get | extracts date/time components from input stream, according to the specified format}}
 {{dcl list end}}

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

Character conversions
toupper
tolower
String and stream conversions
wstring_convert (C++11/17/26*)
wbuffer_convert (C++11/17/26*)

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

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)

cppreference.com

Namespaces

Variants

Views

Actions

Difference between revisions of "cpp/locale/time get"

Revision as of 10:46, 12 October 2012

Contents

Type requirements

Specializations

Member types

Member functions

Member objects

Protected member functions

Inherited from std::time_base

Example

See also

Navigation

Toolbox