Namensräume
Varianten
Aktionen

std::put_time

Von cppreference.com
< cpp‎ | io‎ | manip
 
C++
 
Ein-/Ausgabe-Bibliothek
 
Input/output-Manipulatoren
Formatierung von Gleitkommazahlen
Ganzzahlformatierung
Boolean-Formatierung
Feldbreiten- und Füllzeichensteuerung
Andere Formatierungen
Leerzeichenverarbeitung
Ausgabe-Flushen
(C++20)  

Statusflags-Manipulation
Zeit- und Geld-I/O
(C++11)
(C++11)
(C++11)
put_time
(C++11)
Gequoteter Manipulator
(C++14)
 
Definiert im Header <iomanip>
template< class CharT >
/*unspecified*/ put_time( const std::tm* tmb, const CharT* fmt );
 (seit C++11)

Wenn in einem Ausdruck out << put_time(tmb, fmt) verwendet, konvertiert er die Datums- und Zeitinformationen aus einer gegebenen Kalenderzeit tmb in einen Zeichenstring gemäß der Formatzeichenkette fmt, als ob durch Aufruf von std::strftime, std::wcsftime oder analog (abhängig von CharT) gemäß der std::time_put Facette der aktuell in den Ausgabestrom out eingebetteten Locale.

Inhalt

[bearbeiten] Parameter

tmb - Zeiger auf die Kalenderzeitstruktur, wie sie von std::localtime oder std::gmtime erhalten wurde
fmt - Zeiger auf eine nullterminierte CharT-Zeichenkette, die das Format der Konvertierung angibt

[bearbeiten] Formatzeichenkette

Die Formatzeichenkette besteht aus null oder mehr Konversionsspezifizierern und gewöhnlichen Zeichen (außer %). Alle gewöhnlichen Zeichen, einschließlich des terminierenden Nullzeichens, werden unverändert in den Ausgabestring kopiert. Jede Konversionsspezifikation beginnt mit einem %-Zeichen, optional gefolgt von einem E- oder O-Modifikator (ignoriert, wenn von der Locale nicht unterstützt), gefolgt von dem Zeichen, das das Verhalten des Spezifizierers bestimmt. Die folgenden Format-Spezifizierer sind verfügbar

Konversion
Spezifizierer		 Erklärung Verwendete Felder
% schreibt ein wörtliches %. Die vollständige Konversionsspezifikation muss %% sein.
n
(C++11) 		schreibt ein Zeilenumbruchzeichen
t
(C++11) 		schreibt ein horizontalen Tabulator
Jahr
Y schreibt das Jahr als Dezimalzahl, z.B. 2017 tm_year
EY
(C++11) 		schreibt das Jahr in der alternativen Darstellung, z.B. 平成23年 (Jahr Heisei 23) anstelle von 2011年 (Jahr 2011) in der ja_JP-Locale tm_year
y schreibt die letzten 2 Ziffern des Jahres als Dezimalzahl (Bereich [00,99]) tm_year
Oy
(C++11) 		schreibt die letzten 2 Ziffern des Jahres unter Verwendung des alternativen Zahlensystems, z.B. 十一 anstelle von 11 in der ja_JP-Locale tm_year
Ey
(C++11) 		schreibt das Jahr als Offset von der alternativen Kalenderperiode der Locale %EC (Locale-abhängig) tm_year
C
(C++11) 		schreibt die ersten 2 Ziffern des Jahres als Dezimalzahl (Bereich [00,99]) tm_year
EC
(C++11) 		schreibt den Namen des Basisjahres (Periode) in der alternativen Darstellung der Locale, z.B. 平成 (Heisei-Ära) in ja_JP tm_year
G
(C++11) 		schreibt das ISO 8601 wochenbasierte Jahr, d.h. das Jahr, das die angegebene Woche enthält.

In ISO 8601 beginnen Wochen mit Montag, und die erste Woche des Jahres muss die folgenden Anforderungen erfüllen:

  • Enthält den 4. Januar
  • Enthält den ersten Donnerstag des Jahres
 tm_year, tm_wday, tm_yday
g
(C++11) 		schreibt die letzten 2 Ziffern des ISO 8601 wochenbasierten Jahres, d.h. das Jahr, das die angegebene Woche enthält (Bereich [00,99]).

In ISO 8601 beginnen Wochen mit Montag, und die erste Woche des Jahres muss die folgenden Anforderungen erfüllen:

  • Enthält den 4. Januar
  • Enthält den ersten Donnerstag des Jahres
 tm_year, tm_wday, tm_yday
Monat
b schreibt den verkürzten Monatsnamen, z.B. Okt (Locale-abhängig) tm_mon
h
(C++11) 		Synonym von b tm_mon
B schreibt den vollständigen Monatsnamen, z.B. Oktober (Locale-abhängig) tm_mon
m schreibt den Monat als Dezimalzahl (Bereich [01,12]) tm_mon
Om
(C++11) 		schreibt den Monat unter Verwendung des alternativen Zahlensystems, z.B. 十二 anstelle von 12 in der ja_JP-Locale tm_mon
Week
U schreibt die Woche des Jahres als Dezimalzahl (Sonntag ist der erste Tag der Woche) (Bereich [00,53]) tm_year, tm_wday, tm_yday
OU
(C++11) 		schreibt die Woche des Jahres, wie bei %U, unter Verwendung des alternativen Zahlensystems, z.B. 五十二 anstelle von 52 in der ja_JP-Locale tm_year, tm_wday, tm_yday
W schreibt die Woche des Jahres als Dezimalzahl (Montag ist der erste Tag der Woche) (Bereich [00,53]) tm_year, tm_wday, tm_yday
OW
(C++11) 		schreibt die Woche des Jahres, wie bei %W, unter Verwendung des alternativen Zahlensystems, z.B. 五十二 anstelle von 52 in der ja_JP-Locale tm_year, tm_wday, tm_yday
V
(C++11) 		schreibt die ISO 8601 Woche des Jahres (Bereich [01,53]).

In ISO 8601 beginnen Wochen mit Montag, und die erste Woche des Jahres muss die folgenden Anforderungen erfüllen:

  • Enthält den 4. Januar
  • Enthält den ersten Donnerstag des Jahres
 tm_year, tm_wday, tm_yday
OV
(C++11) 		schreibt die Woche des Jahres, wie bei %V, unter Verwendung des alternativen Zahlensystems, z.B. 五十二 anstelle von 52 in der ja_JP-Locale tm_year, tm_wday, tm_yday
Tag des Jahres/Monats
j schreibt den Tag des Jahres als Dezimalzahl (Bereich [001,366]) tm_yday
d schreibt den Tag des Monats als Dezimalzahl (Bereich [01,31]) tm_mday
Od
(C++11) 		schreibt den nullbasierten Tag des Monats unter Verwendung des alternativen Zahlensystems, z.B. 二十七 anstelle von 27 in der ja_JP-Locale

Ein einzelnes Zeichen wird von einem Leerzeichen gefolgt.

 tm_mday
e
(C++11) 		schreibt den Tag des Monats als Dezimalzahl (Bereich [1,31]).

Eine einzelne Ziffer wird von einem Leerzeichen gefolgt.

 tm_mday
Oe
(C++11) 		schreibt den einsbasierten Tag des Monats unter Verwendung des alternativen Zahlensystems, z.B. 二十七 anstelle von 27 in der ja_JP-Locale

Ein einzelnes Zeichen wird von einem Leerzeichen gefolgt.

 tm_mday
Wochentag
a schreibt den verkürzten Wochentagsnamen, z.B. Fr (Locale-abhängig) tm_wday
A schreibt den vollständigen Wochentagsnamen, z.B. Freitag (Locale-abhängig) tm_wday
w schreibt den Wochentag als Dezimalzahl, wobei Sonntag 0 ist (Bereich [0-6]) tm_wday
Ow
(C++11) 		schreibt den Wochentag, wobei Sonntag 0 ist, unter Verwendung des alternativen Zahlensystems, z.B. 二 anstelle von 2 in der ja_JP-Locale tm_wday
u
(C++11) 		schreibt den Wochentag als Dezimalzahl, wobei Montag 1 ist (ISO 8601-Format) (Bereich [1-7]) tm_wday
Ou
(C++11) 		schreibt den Wochentag, wobei Montag 1 ist, unter Verwendung des alternativen Zahlensystems, z.B. 二 anstelle von 2 in der ja_JP-Locale tm_wday
Stunde, Minute, Sekunde
H schreibt die Stunde als Dezimalzahl, 24-Stunden-Uhr (Bereich [00-23]) tm_hour
OH
(C++11) 		schreibt die Stunde der 24-Stunden-Uhr unter Verwendung des alternativen Zahlensystems, z.B. 十八 anstelle von 18 in der ja_JP-Locale tm_hour
I schreibt die Stunde als Dezimalzahl, 12-Stunden-Uhr (Bereich [01,12]) tm_hour
OI
(C++11) 		schreibt die Stunde der 12-Stunden-Uhr unter Verwendung des alternativen Zahlensystems, z.B. 六 anstelle von 06 in der ja_JP-Locale tm_hour
M schreibt die Minute als Dezimalzahl (Bereich [00,59]) tm_min
OM
(C++11) 		schreibt die Minute unter Verwendung des alternativen Zahlensystems, z.B. 二十五 anstelle von 25 in der ja_JP-Locale tm_min
S schreibt die Sekunde als Dezimalzahl (Bereich [00,60]) tm_sec
OS
(C++11) 		schreibt die Sekunde unter Verwendung des alternativen Zahlensystems, z.B. 二十四 anstelle von 24 in der ja_JP-Locale tm_sec
Sonstiges
c schreibt die Standard-Datums- und Zeitzeichenkette, z.B. So Okt 17 04:41:13 2010 (Locale-abhängig) all
Ec
(C++11) 		schreibt die alternative Datums- und Zeitzeichenkette, z.B. unter Verwendung von 平成23年 (Jahr Heisei 23) anstelle von 2011年 (Jahr 2011) in der ja_JP-Locale all
x schreibt die lokalisierte Datumsdarstellung (Locale-abhängig) all
Ex
(C++11) 		schreibt die alternative Datumsdarstellung, z.B. unter Verwendung von 平成23年 (Jahr Heisei 23) anstelle von 2011年 (Jahr 2011) in der ja_JP-Locale all
X schreibt die lokalisierte Zeitdarstellung, z.B. 18:40:20 oder 6:40:20 PM (Locale-abhängig) all
EX
(C++11) 		schreibt die alternative Zeitdarstellung (Locale-abhängig) all
D
(C++11) 		entspricht "%m/%d/%y" tm_mon, tm_mday, tm_year
F
(C++11) 		entspricht "%Y-%m-%d" (das ISO 8601 Datumsformat) tm_mon, tm_mday, tm_year
r
(C++11) 		schreibt die lokalisierte 12-Stunden-Uhrzeit (Locale-abhängig) tm_hour, tm_min, tm_sec
R
(C++11) 		entspricht "%H:%M" tm_hour, tm_min
T
(C++11) 		entspricht "%H:%M:%S" (das ISO 8601 Zeitformat) tm_hour, tm_min, tm_sec
p schreibt die lokalisierte vormittags- oder nachmittagsangabe (Locale-abhängig) tm_hour
z
(C++11) 		schreibt den Offset von UTC im ISO 8601-Format (z.B. -0430) oder keine Zeichen, wenn die Zeitzoneninformation nicht verfügbar ist tm_isdst
Z schreibt den Locale-abhängigen Zeitzonennamen oder die Abkürzung, oder keine Zeichen, wenn die Zeitzoneninformation nicht verfügbar ist tm_isdst

[bearbeiten] Rückgabewert

Ein Objekt eines nicht spezifizierten Typs, so dass

  • Wenn out ein Objekt vom Typ std::basic_ostream<CharT, Traits> ist, verhält sich der Ausdruck out << put_time(tmb, fmt)
    • vom Typ std::basic_ostream<CharT, Traits>& ist
    • hat den Wert out
    • so, als ob er f(out, tmb, fmt) aufrufen würde

wobei die Funktion f definiert ist als

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, const std::tm* tmb, const CharT* fmt)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using TimePut = std::time_put<CharT, Iter>;
 
    const TimePut& tp = std::use_facet<TimePut>(str.getloc());
    const Iter end = tp.put(Iter(str.rdbuf()), str, str.fill(), tmb,
        fmt, fmt + Traits::length(fmt));
 
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

[bearbeiten] Beispiel

Führen Sie diesen Code aus
#include <ctime>
#include <iomanip>
#include <iostream>
 
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") << '\n';
 
    std::cout.imbue(std::locale("ja_JP.utf8"));
    std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << '\n';
}

Mögliche Ausgabe

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

[bearbeiten] Siehe auch

 formatiert den Inhalt von std::tm für die Ausgabe als Zeichensequenz
(Klassentemplate) [bearbeiten]
(C++11)
 Parst einen Datums-/Zeitwert nach dem angegebenen Format
(Funktion-Template) [bearbeiten]
 konvertiert ein std::tm-Objekt in eine benutzerdefinierte textuelle Darstellung
(Funktion) [bearbeiten]
 konvertiert ein std::tm-Objekt in eine benutzerdefinierte Textdarstellung als breites Zeichen-String
(Funktion) [bearbeiten]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/io/manip/put_time&oldid=159179"