std::time_get_byname

From cppreference.com

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)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Text processing library

Localization library

Regular expressions library(C++11)

Formatting library(C++20)

Null-terminated sequence utilities

Byte strings

Multibyte strings

Wide strings

Primitive numeric conversions

to_chars (C++17)
to_chars_result (C++17)
from_chars (C++17)
from_chars_result (C++17)
chars_format (C++17)

Text encoding identifications

text_encoding

(C++26)

[edit]

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

Character classification and conversion

Character classification

isspace
iscntrl
isupper

islower
isalpha
ispunct

isdigit
isxdigit
isalnum

isblank (C++11)
isprint
isgraph

Character conversions

toupper

tolower

String and stream conversions

wstring_convert

(C++11/17/26*)

wbuffer_convert

(C++11/17/26*)

Unicode conversion facets

(C++11/17/26*)

(C++11/17/26*)

(C++11/17/26*)

(C++11/17/26*)

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

setlocale
localeconv
lconv

[edit]

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

std::time_get_byname is astd::time_get facet which encapsulates time and date parsing rules of the locale specified at its construction.

[edit]Specializations

The standard library is guaranteed to provide every specialization that satisfies the following type requirements:

CharT is one ofchar andwchar_t, and
InputIt must meet the requirements ofLegacyInputIterator.

[edit]Nested types

Type	Definition
`char_type`	`CharT`
`iter_type`	`InputIt`

[edit]Member functions

(constructor)	constructs a new`time_get_byname` facet (public member function)[edit]
(destructor)	destroys a`time_get_byname` facet (protected member function)[edit]

[edit]

std::time_get_byname::time_get_byname

explicit time_get_byname(constchar* name,std::size_t refs=0);
explicit time_get_byname(conststd::string& name,std::size_t refs=0);		(since C++11)

Constructs a newstd::time_get_byname facet for a locale withname.

refs is used for resource management: ifrefs==0, the implementation destroys the facet, when the laststd::locale object holding it is destroyed. Otherwise, the object is not destroyed.

Parameters

name	-	the name of the locale
refs	-	the number of references that link to the facet

[edit]

std::time_get_byname::~time_get_byname

protected: ~time_get_byname();

Destroys the facet.

Inherited fromstd::time_get

Nested types

Type	Definition
`char_type`	`CharT`
`iter_type`	`InputIt`

[edit]Data members

Member	Description
std::locale::id`id`[static]	the identifier of thefacet

Member functions

date_order	invokes`do_date_order` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get_time	invokes`do_get_time` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get_date	invokes`do_get_date` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get_weekday	invokes`do_get_weekday` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get_monthname	invokes`do_get_monthname` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get_year	invokes`do_get_year` (public member function of`std::time_get<CharT,InputIt>`)[edit]
get (C++11)	invokes`do_get` (public member function of`std::time_get<CharT,InputIt>`)[edit]

Protected member functions

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

Inherited fromstd::time_base

Nested types

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

[edit]Example

This section is incomplete
Reason: no example

[edit]See also

time_get	parses time/date values from an input character sequence intostd::tm (class template)[edit]
get_time (C++11)	parses a date/time value of specified format (function template)[edit]