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

定义于头文件

 

 

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

std::get_time

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

参数

返回值

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

typedef std::istreambuf_iterator<CharT, Traits> Iter;
typedef std::time_get<CharT, Iter> TimeGet;
std::ios_base::iostate err = std::ios_base::goodbit;
const TimeGet& tg = std::use_facet<TimeGet>(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 <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
 
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

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

参数

返回值

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

typedef std::ostreambuf_iterator<CharT, Traits> Iter;
typedef std::time_put<CharT, Iter> TimePut;
const TimePut& tp = std::use_facet<TimePut>(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 <iostream>
#include <iomanip>
#include <ctime>
 
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