C++标准模板（STL）- 输入/输出操纵符-(std::get_time,std::put_time)

操纵符是令代码能以 operator<< 或 operator>> 控制输入/输出流的帮助函数。

不以参数调用的操纵符（例如 std::cout << std::boolalpha; 或 std::cin >> std::hex; ）实现为接受到流的引用为其唯一参数的函数。 basic_ostream::operator<< 和 basic_istream::operator>> 的特别重载版本接受指向这些函数的指针。这些函数（或函数模板的实例化）是标准库中仅有的可取址函数。 (C++20 起)

以参数调用的操纵符（例如 std::cout << std::setw(10); ）实现为返回未指定类型对象的函数。这些操纵符定义其自身的进行请求操作的 operator<< 或 operator>> 。

定义于头文件

转换指定符 解释 写入域 % 匹配字面 % 。完整转换指定必须是 %% 。 （无） t 匹配任何空白符。 （无） n 匹配任何空白符。 （无） 年 Y 分析完整年为四位十进制数，容许但不要求前导零 tm_year EY 以替用表示分析年，例如 平成23年 在 ja_JP 本地环境中写 2011 到 tm_year tm_year y 分析年的后二位为十进制数。范围 [69,99] 生成 1969 至 1999 的值，范围 [00,68] 生成 2000-2068 tm_year Oy 以替用数值系统分析年的后二位数字，例如 十一 在 ja_JP 本地环境中被分析为 11 tm_year Ey 分析年为从本地环境的替用日历周期 %EC 的偏移 tm_year C 分析年的首 2 位数字为十进制数（范围 [00,99] ） tm_year EC 分析本地环境的替用表示中，年基底（周期）的名称，例如 ja_JP 中的 平成 tm_year 月 b 分析月份名，完整或缩写，例如 Oct tm_mon h b 的同义词 tm_mon B b 的同义词 tm_mon m 分析月为十进制数（范围 [01,12] ），容许但不要求前导零 tm_mon Om 用替代数值系统分析月，例如 ja_JP 本地环境中 十二 分析为 12 tm_mon 星期 U 分析年之星期为十进制数（星期日是星期的首日）（范围 [00,53] ），容许但不要求前导零 tm_year, tm_wday, tm_yday OU 用替用数值系统，如以 %U 一般分析年之星期，例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday W 分析年之星期为十进制数（星期一是星期的首日）（范围 [00,53] ），容许但不要求前导零 tm_year, tm_wday, tm_yday OW 用替用数值系统，如以 %W 一般分析年之星期，例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday 年/月之日 j 分析年之日为十进制数（范围 [001,366] ），容许但不要求前导零 tm_yday d 分析月之日为十进制数（范围 [01,31] ），容许但不要求前导零 tm_mday Od 用替用数值系统分析月之日，例如 ja_JP 本地环境中 二十七 分析为 27 ，容许但不要求前导零 tm_mday e d 的同义词 tm_mday Oe Od 的同义词 tm_mday 星期之日 a 分析星期的日名，完整或缩写版，例如 Fri tm_wday A a 的同义词 tm_wday w 分析星期之日为十进制数，其中星期日为 0 （范围 [0-6] ） tm_wday Ow 用替用数值系统分析星期之日为十进制数，其中星期日为 0 ，例如 ja_JP 本地环境中 二 分析为 2 tm_wday 时、分、秒 H 分析时为十进制数，以 24 小时时钟（范围 [00,23] ） ，容许但不要求前导零 tm_hour OH 用替用数值系统分析来自 24 小时时钟的时，例如 ja_JP 本地环境中 十八 分析为 18 tm_hour I 分析时为十进制数，以 12 小时时钟（范围 [01,12] ） ，容许但不要求前导零 tm_hour OI 用替用数值系统分析时，例如 ja_JP 本地环境中 六 分析为 6 tm_hour M 分析分为十进制数（范围 [00,59] ），容许但不要求前导零 tm_min OM 用替用数值系统分析分，例如 ja_JP 本地环境中 二十五 分析为 25 tm_min S 分析秒为十进制数（范围 [00,60] ），容许但不要求前导零 tm_sec OS 用替用数值系统分析秒，例如 ja_JP 本地环境中 二十四 分析为 24 tm_sec 其他 c 分析本地环境的标准日期和时间字符串格式，例如 Sun Oct 17 04:41:13 2010 （本地环境依赖） 所有 Ec 分析本地环境的替用时期和时间字符串格式，例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有 x 分析本地环境的标准日期表示 所有 Ex 分析本地环境的替用日期表示，例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有 X 分析本地环境的标准时间表示 所有 EX 分析本地环境的替用时间表示 所有 D 等价于 "%m / %d / %y " tm_mon, tm_mday, tm_year r 等价于本地环境的标准 12 小时时钟时间（ POSIX 中为 "%I : %M : %S %p" ） tm_hour, tm_min, tm_sec R 等价于 "%H : %M" tm_hour, tm_min T 等价于 "%H : %M : %S" tm_hour, tm_min, tm_sec p 分析 a.m. 或 p.m. 的本地环境等价版本 tm_hour

注意：不写入 tm_isdst ，需要用如 mktime 的函数显式设置它。

 

 

剖析指定格式的日期/时间值 

std::get_time

template< class CharT > /*unspecified*/ get_time( std::tm* tmb, const CharT* fmt );

(C++11 起)

 用于表达式 in >> get_time(tmb, fmt) 时，按照格式字符串 fmt 及输入流 in 中当前感染的 locale 的 std::time_get 平面，分析字符输入为日期/时间值。存储结果值于 tmb 所指向的 std::tm 对象中。

参数

tmb	-	指向 std::tm 对象的合法指针，结果将存储于其处
fmt	-	指向指定转换格式的空终止 CharT 字符串的指针 格式字符串由零或更多转换指定符、空白符和通常字符（除了 % ）组成。期待每个通常字符以大小无关比较匹配输入流中的一个字符。每个空白符匹配输入字符串中的任意空白符。每个转换指定始于 % 字符，可选地后随 E 或 O 修饰符（若本地环境不支持则忽略），后随确定指定符转换行为的字符。格式指定符匹配 POSIX 函数 strptime() ：

返回值

返回未指定类型的对象，使得若 in 为 std::basic_istream 类型输出流的名称，则表达式 in >> get_time(tmb, fmt) 表现为如同执行下列代码：

typedef std::istreambuf_iterator Iter;
typedef std::time_get TimeGet;
std::ios_base::iostate err = std::ios_base::goodbit;
const TimeGet& tg = std::use_facet(in.getloc());
 tg.get(Iter(in.rdbuf()), Iter(), in, err, tmb, fmt, fmt + traits::length(fmt));
if (err != std::ios_base::goodbit)
     in.setstate(err);

调用示例

#include 
#include 
#include 
#include 

int main()
{
    std::tm t = {};
    std::istringstream ss("2011-Februar-18 23:12:34");
    ss.imbue(std::locale("de_DE.utf-8"));
    ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
    if (ss.fail())
    {
        std::cout << "Parse failed\n";
    }
    else
    {
        std::cout << std::put_time(&t, "%c") << '\n';
    }
    return 0;
}

输出

Sun Feb 18 23:12:34 2011

按照指定格式格式化并输出日期/时间值

std::put_time

template< class CharT > /*unspecified*/ put_time( const std::tm* tmb, const CharT* fmt );

(C++11 起)

用于表达式 out << put_time(tmb, fmt) 时，按照格式字符串 fmt ，按照输出流 out 中当前感染的 locale 的 std::time_put 平面，转换来自给定的日历时间 tmb 的日期和时间信息为字符串，如同通过调用 std::strftime 、 std::wcsftime 或模拟（取决于 CharT ）。

参数

tmb	-	指向从 localtime() 或 gmtime() 获得的日历时间结构体的指针
fmt	-	指向指定转换格式的空终止 CharT 串的指针。 格式字符串由零或更多个限定符和通常字符（除 % ）构成。所有通常字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换限定符都始于 % 字符，可选地跟随 E 或 O 修饰符（若本地环境不支持则忽略），后随决定修饰符行为的字符。下列修饰符格式可用：

返回值

返回为指定类型的对象，使得若 out 为 std::basic_ostream 类型输出流的名称，则表达式 out << put_time(tmb, fmt) 表现为如同执行下列代码：

typedef std::ostreambuf_iterator Iter;
typedef std::time_put TimePut;
const TimePut& tp = std::use_facet(out.getloc());
const Iter end = tp.put(Iter(out.rdbuf()), out, out.fill(), tmb, fmt, fmt + Traits::length(fmt));
if (end.failed())
     out.setstate(std::ios_base::badbit);

调用示例

#include 
#include 
#include 

int main()
{
    std::time_t t = std::time(nullptr);
    std::tm tm = *std::localtime(&t);
//    std::cout.imbue(std::locale("ru_RU.utf8"));
    std::cout << "ru_RU: " << std::put_time(&tm, "%c %Z") << std::endl;
//    std::cout.imbue(std::locale("ja_JP.utf8"));
    std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << std::endl;
    return 0;
}

输出

ru_RU: Ср. 28 дек. 2011 10:21:16 EST
ja_JP: 2011年12月28日 10時21分16秒 EST