std::time_get<CharT,InputIt>::get_date, std::time_get<CharT,InputIt>::do_get_date

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

本地化库

本地环境与平面
本地环境
locale
use_facet	has_facet
平面类别基类
ctype_base codecvt_base messages_base	time_base money_base
ctype（字符类别）平面
ctype ctype_byname ctype<char>	codecvt codecvt_byname
numeric（数值）平面
num_get num_put	numpunct numpunct_byname
collate（对照比较）平面
collate	collate_byname
time（时间）平面
time_get time_get_byname	time_put time_put_byname
monetary（货币）平面
money_get money_put	moneypunct moneypunct_byname
messages（消息）平面
messages	messages_byname
字符分类与转换
字符分类
isspace isblank (C++11) iscntrl isupper islower isalpha	isdigit ispunct isxdigit isalnum isprint isgraph
转换
toupper tolower	wstring_convert (C++11) wbuffer_convert (C++11)
编码转换平面
codecvt_utf8 (C++11) codecvt_utf16 (C++11)	codecvt_utf8_utf16 (C++11) codecvt_mode (C++11)
C 本地环境
LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	setlocale localeconv lconv

 

std::time_get

成员函数

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

 

在标头 <locale> 定义
public: iter_type get_date( iter_type beg, iter_type end, std::ios_base& str,                     std::ios_base::iostate& err, std::tm* t ) const;	(1)
protected: virtual iter_type do_get_date( iter_type beg, iter_type end, std::ios_base& str,                                std::ios_base::iostate& err, std::tm* t ) const;	(2)

1) 公开成员函数，调用最终派生类的受保护虚成员函数 do_get_date。

2) 从序列 [beg, end) 读取相继字符，并按与为函数 std::get_time、time_get::get 和 POSIX 函数 strptime() 所用的此本地环境所期待的默认格式解析日历日期值。默认格式如下：

date_order()	格式
no_order	"%m/%d/%y"
dmy	"%d/%m/%y"
mdy	"%m/%d/%y"
ymd	"%y/%m/%d"
ydm	"%y/%d/%m"

将解析出的日期存储到参数 t 指向的 std::tm 结构体的对应域中。

如果在读到合法日期前抵达尾迭代器，那么函数会设置 err 中的 std::ios_base::eofbit。如果遇到解析错误，那么函数会设置 err 中的 std::ios_base::failbit。

参数

beg	-	指代要解析的序列起始的迭代器
end	-	要解析的序列的尾后一位置迭代器
str	-	此函数在需要时用以获得本地环境平面的流对象，例如用 std::ctype 跳过空白符或用 std::collate 比较字符串
err	-	此函数所修改以指示错误的流错误标志对象
t	-	指向 std::tm 对象的指针，该对象将保有此函数调用结果

返回值

指向 [beg, end) 中辨识为合法日期一部分的末字符后一位置的迭代器。

注意

对于默认时间格式的字母组分（如果存在），此函数通常不区别大小写。

如果遇到解析错误，那么此函数的大多数实现保留 *t 不修改。

实现可以支持标准所要求之外的其他日期格式。

示例

运行此代码

#include <iostream>
#include <locale>
#include <sstream>
#include <iterator>
#include <ctime>
 
void try_get_date(const std::string& s)
{
    std::cout << "在本地环境 " << std::locale().name()
              << " 中从 '" << s << "' 解析日期\n";
    std::istringstream str(s);
    std::ios_base::iostate err = std::ios_base::goodbit;
 
    std::tm t;
    std::time_get<char> facet = std::use_facet<std::time_get<char>>(str.getloc())
    std::istreambuf_iterator<char> ret = facet.get_date({str}, {}, str, err, &t);
    str.setstate(err);
 
    if (str)
    {
        std::cout << "年：" << t.tm_year + 1900 << ' '
                  << "月：" << t.tm_mon + 1 << ' '
                  << "日：" << t.tm_mday << '\n';
    }
    else
    {
        std::cout << "解析失败。尚未解析的字符串：";
        std::copy(ret, {}, std::ostreambuf_iterator<char>(std::cout));
        std::cout << '\n';
    }
}
 
int main()
{
    std::locale::global(std::locale("en_US.utf8"));
    try_get_date("02/01/2013");
    try_get_date("02-01-2013");
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_get_date("2013年02月01日");
}

输出：

在本地环境 en_US.utf8 中从 '02/01/2013' 解析日期
年：2013 月：2 日：1
在本地环境 en_US.utf8 中从 '02-01-2013' 解析日期
解析失败。尚未解析的字符串：-01-2013
在本地环境 ja_JP.utf8 中从 '2013年02月01日' 解析日期
年：2013 月：2 日：1

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 248	C++98	在抵达尾迭代器时不会设置 eofbit	在没有读取到合法日期的情况下会设置 eofbit
LWG 461	C++98	do_get_date 需要解析本地化的日期表示	以通过 date_order() 决定的格式解析

参阅

get_time (C++11)

剖析指定格式的日期/时间值 (函数模板)