C++-Standardvorlage (STL) – Eingabe-/Ausgabe-Manipulator – (std::get_time,std::put_time)

Operatoren sind Hilfsfunktionen, die es Code ermöglichen, Eingabe-/Ausgabeströme mithilfe von Operator<< oder Operator>> zu steuern.

Ohne Argumente aufgerufene Manipulatoren (z. B. std::cout << std::boolalpha; oder std::cin >> std::hex; ) werden als Funktionen implementiert, die einen Verweis auf einen Stream als einziges Argument akzeptieren. Spezielle überladene Versionen von basic_ostream::operator<< und basic_istream::operator>> akzeptieren Zeiger auf diese Funktionen. Diese Funktionen (oder Instanziierungen von Funktionsvorlagen) sind die einzigen adressierbaren Funktionen in der Standardbibliothek. (seit C++20)

Mit Argumenten aufgerufene Manipulatoren (z. B. std::cout << std::setw(10); ) werden als Funktionen implementiert, die ein Objekt eines nicht angegebenen Typs zurückgeben. Diese Operatoren definieren ihren eigenen Operator<< oder Operator>>, der die angeforderte Operation ausführt.

Definiert in der Header-Datei <iomanip>

Konvertierungsspezifizierer erklären Schreibdomäne % Übereinstimmungsliterale %. Die vollständige Konvertierungsspezifikation muss lauten %%. (keiner) t Entspricht jedem Leerzeichen. (keiner) n Entspricht jedem Leerzeichen. (keiner) Jahr Y Analysiert ein vollständiges Jahr als vierstellige Dezimalzahl. Führende Nullen sind zulässig, aber nicht erforderlich tm_year EY Verwenden Sie eine Alternative, um das Analysejahr darzustellen . Schreiben Sie beispielsweise in Heisei 23 2011 in tm_year in der lokalen Umgebung ja_JP. tm_year y Die letzten beiden Ziffern des Analysejahres sind Dezimalzahlen. Range [69,99]generiert Werte von 1969 bis 1999, Range [00,68]generiert Werte von 2000 bis 2068 tm_year Oy Analysiert die letzten beiden Ziffern des Jahres in einem alternativen numerischen System , z. B. wird elf im Gebietsschema ja_JP als 11 analysiert tm_year Ey Das Analysejahr ist%EC ein Offset zum alternativen Kalenderzeitraum der lokalen Umgebung tm_year C Analysieren Sie die ersten beiden Ziffern des Jahres[00,99] als Dezimalzahl (Bereich ). tm_year EC Der Name der Jahresbasis (Periode) in der alternativen Darstellung des Parsing-Gebietsschemas, z. B. Heisei in ja_JP tm_year Mond b Analysieren Sie Monatsnamen, vollständig oder abgekürzt, z. B.Oct tm_mon h bSynonyme für tm_mon B bSynonyme für tm_mon m Analysiert den Monat als Dezimalzahl (Bereich [01,12]), führende Nullen sind zulässig, aber nicht erforderlich tm_mon Om Verwenden Sie ein alternatives numerisches System, um den Monat zu analysieren , z. B. ja_JP in der lokalen Umgebung zwölf wird als 12 analysiert tm_mon Woche U Analysiert den Tag des Jahres als Dezimalzahl (Sonntag ist der erste Tag der Woche) (Bereich [00,53]), führende Nullen sind zulässig, aber nicht erforderlich tm_year, tm_wday,tm_yday OU Verwenden Sie ein alternatives numerisches System, z. B. %Udie allgemeine Analyse des Tages des Jahres . Beispielsweise ist die lokale Umgebungsanalyse von ja_JP für 52 52 tm_year, tm_wday,tm_yday W Analysiert den Tag des Jahres als Dezimalzahl (Montag ist der erste Tag der Woche) (Bereich [00,53]), führende Nullen sind zulässig, aber nicht erforderlich tm_year, tm_wday,tm_yday OW Verwenden Sie ein alternatives numerisches System, z. B. %Wdie allgemeine Analyse des Tages des Jahres . Beispielsweise ist die lokale Umgebungsanalyse von ja_JP für 52 52 tm_year, tm_wday,tm_yday Tag des Jahres/Monats j Analysiert den Tag des Jahres als Dezimalzahl (Bereich [001,366]), führende Nullen sind zulässig, aber nicht erforderlich tm_yday d Analysiert den Tag des Monats als Dezimalzahl (Bereich [01,31]), führende Nullen sind zulässig, aber nicht erforderlich tm_mday Od Verwenden Sie ein alternatives numerisches System, um den Tag des Monats zu analysieren , beispielsweise ja_JP. Siebenundzwanzig wird in der lokalen Umgebung von ja_JP als 27 analysiert. Führende Nullen sind zulässig, aber nicht erforderlich. tm_mday e dSynonyme für tm_mday Oe OdSynonyme für tm_mday Wochentag a Analysieren Sie den Namen des Wochentags, vollständige oder abgekürzte Version, z. B.Fri tm_wday A aSynonyme für tm_wday w Analysiert den Wochentag als Dezimalzahl, wobei Sonntag 0(Bereich [0-6]) ist. tm_wday Ow Verwenden Sie ein alternatives numerisches System, um den Wochentag als Dezimalzahl zu analysieren, wobei Sonntag 0beispielsweise ist, analysiert ja_JP den Wochentag in der lokalen Umgebung als 2 tm_wday Minuten und Sekunden H Wird als Dezimalzahl im 24-Stunden-Format geparst [00,23], führende Nullen sind zulässig, aber nicht erforderlich tm_hour OH Analysieren Sie Stunden anhand eines 24-Stunden-Formats unter Verwendung eines alternativen numerischen Systems , z. B. achtzehn im Gebietsschema ja_JP wird als 18 analysiert tm_hour I Analysiert als Dezimalzahl im 12-Stunden-Format [01,12], führende Nullen sind zulässig, aber nicht erforderlich tm_hour OI Bei der Analyse mit einem alternativen numerischen System , beispielsweise ja_JP, wird sechs in der lokalen Umgebung als 6 analysiert tm_hour M Analysiert in Dezimalzahlen (Bereich [00,59]), führende Nullen sind zulässig, aber nicht erforderlich tm_min OM Verwenden Sie ein alternatives numerisches System, um Punkte zu analysieren . Beispielsweise wird ja_JP in der lokalen Umgebung fünfundzwanzig als 25 analysiert tm_min S Analysieren Sie Sekunden als Dezimalzahl (Bereich [00,60]), führende Nullen sind zulässig, aber nicht erforderlich 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<CharT, Traits> 类型输出流的名称，则表达式 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

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<CharT, Traits> 类型输出流的名称，则表达式 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