std::wcsftime

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono E/A parse (C++20)

Zeitzone tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C-Stil Datums- und Zeitfunktionen

 

C-Stil Datums- und Zeitwerkzeuge

Funktionen

Zeitmanipulation

difftime

time

clock

timespec_get (C++17)

Formatkonvertierungen

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

Konstanten

CLOCKS_PER_SEC

Typen

tm

time_t

clock_t

timespec (C++17)

 

Definiert in Header <cwchar>
std::size_t wcsftime( wchar_t* str, std::size_t count, const wchar_t* format, const std::tm* time );

Konvertiert die Datums- und Uhrzeitinformationen aus einer gegebenen Kalenderzeit time in eine nullterminierte Wide-Character-Zeichenkette str gemäß der Formatierungszeichenkette format. Es werden bis zu count Wide-Characters geschrieben.

Parameter

str	-	Zeiger auf das erste Element des wchar_t-Arrays für die Ausgabe
zählt	-	maximale Anzahl von zu schreibenden Wide-Zeichen
format	-	Zeiger auf eine nullterminierte Wide-Character-Zeichenkette, die das Format der Konvertierung angibt
time	-	Zeiger auf die zu konvertierenden Datums- und Uhrzeitinformationen

Formatierungszeichenkette

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

Rückgabewert

Anzahl der in das Wide-Character-Array, auf das von str gezeigt wird, geschriebenen Wide-Characters, die nicht das abschließende L'\0' bei Erfolg enthalten. Wenn count erreicht wurde, bevor die gesamte Zeichenkette gespeichert werden konnte, wird ​0​ zurückgegeben und der Inhalt ist undefiniert.

Beispiel

Führen Sie diesen Code aus

#include <ctime>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::time_t t = std::time(nullptr);
    wchar_t wstr[100];
    if (std::wcsftime(wstr, 100, L"%A %c", std::localtime(&t)))
        std::wcout << wstr << '\n';
}

Mögliche Ausgabe

火曜日 2011年12月27日 17時43分13秒

Siehe auch

strftime	konvertiert ein std::tm-Objekt in eine benutzerdefinierte textuelle Darstellung (Funktion)
put_time (C++11)	Formatiert und gibt einen Datums-/Zeitwert gemäß dem angegebenen Format aus (Funktion-Template)
C-Dokumentation für wcsftime