std::chrono::from_stream (std::chrono::year_month_day)

 

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

 

std::chrono::year_month_day

Memberfunktionen

year_month_day::year_month_day

year_month_day::operator+=year_month_day::operator-=

year_month_day::yearyear_month_day::monthyear_month_day::day

year_month_day::operator sys_daysyear_month_day::operator local_days

year_month_day::ok

Nicht-Member-Funktionen

operator==operator<=>

operator+operator-

operator<<

from_stream

Hilfsklassen

formatter<std::chrono::year_month_day>

hash<std::chrono::year_month_day> (C++26)

 

Definiert in Header <chrono>
template< class CharT, class Traits, class Alloc = std::allocator<CharT> > std::basic_istream<CharT, Traits>&     from_stream( std::basic_istream<CharT, Traits>& is, const CharT* fmt,                  std::chrono::year_month_day& ymd,                  std::basic_string<CharT, Traits, Alloc>* abbrev = nullptr,                  std::chrono::minutes* offset = nullptr );		(seit C++20)

Versucht, den Eingabestrom is gemäß der Formatzeichenkette fmt in die std::chrono::year_month_day ymd zu parsen.

Verhält sich wie eine UnformattedInputFunction, mit der Ausnahme, dass die Auswirkungen auf is.gcount() nicht spezifiziert sind. Nach dem Erstellen und Überprüfen des Sentry-Objekts wird versucht, den Eingabestrom is gemäß der Formatzeichenkette fmt in ymd zu parsen. Wenn das Parsen fehlschlägt, eine gültige year_month_day zu dekodieren, wird is.setstate(std::ios_base::failbit) aufgerufen und ymd nicht geändert.

Wenn der Formatbezeichner %Z verwendet und erfolgreich geparst wird, wird der geparste Wert *abbrev zugewiesen, wenn abbrev nicht null ist. Wenn der Formatbezeichner %z oder eine modifizierte Variante verwendet und erfolgreich geparst wird, wird der geparste Wert *offset zugewiesen, wenn offset nicht null ist.

Parameter

ist	-	ein Eingabestrom
fmt	-	eine Formatzeichenkette (siehe unten)
ymd	-	Objekt zur Aufnahme des Parse-Ergebnisses
abbrev	-	wenn nicht null, Zeiger auf ein Objekt, das die Zeitzonenkürzel oder den Namen im Zusammenhang mit dem %Z-Spezifizierer aufnehmen wird
offset	-	wenn nicht null, Zeiger auf ein Objekt, das den Offset von UTC im Zusammenhang mit dem %z-Spezifizierer aufnehmen wird

Formatierungsstring

Die Formatzeichenkette besteht aus null oder mehr Konvertierungsspezifizierern und normalen Zeichen. Jedes normale Zeichen, ausgenommen Leerzeichen und das abschließende Nullzeichen, passt zu einem identischen Zeichen aus dem Eingabestrom oder führt zum Fehlschlagen der Funktion, wenn das nächste Zeichen im Strom nicht gleich ist.

Jedes Leerzeichen passt zu null oder mehr Leerzeichen im Eingabestrom.

Jeder unveränderte Konvertierungsspezifizierer beginnt mit einem %-Zeichen, gefolgt von einem Zeichen, das das Verhalten des Spezifizierers bestimmt. Einige Konvertierungsspezifizierer haben eine modifizierte Form, bei der ein E- oder O-Modifikatorzeichen nach dem %-Zeichen eingefügt wird. Einige Konvertierungsspezifizierer haben eine modifizierte Form, bei der ein Breitenparameter, der als positive Dezimalzahl angegeben ist (nachfolgend als N gezeigt), nach dem %-Zeichen eingefügt wird. Jeder Konvertierungsspezifizierer bewirkt, dass die abgeglichenen Zeichen gemäß der folgenden Tabelle als Teile von Datums- und Zeitdatentypen interpretiert werden.

Eine Zeichensequenz in der Formatzeichenkette, die mit einem % beginnt, aber nicht mit einem der folgenden Konvertierungsspezifizierer übereinstimmt, wird als normales Zeichen interpretiert.

Wenn from_stream nicht alles parsen kann, was durch die Formatzeichenkette spezifiziert ist, oder wenn nicht genügend Informationen zum Parsen einer vollständigen Ergebnisangabe vorhanden sind, oder wenn beim Parsen widersprüchliche Informationen aufgedeckt werden, wird is.setstate(std::ios_base::failbit) aufgerufen.

Die folgenden Konvertierungsspezifizierer sind verfügbar

Konversion Spezifizierer	Erklärung
%%	Passt zu einem literalen %-Zeichen.
%n	Passt zu einem Leerzeichen.
%t	Passt zu null oder einem Leerzeichen.
Jahr
%C %NC %EC	Parst das Jahrhundert als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %EC interpretiert die alternative Darstellung des Jahrhunderts der Locale.
%y %Ny %Ey %Oy	Parst die letzten zwei Dezimalziffern des Jahres. Wenn das Jahrhundert nicht anderweitig angegeben ist (z. B. mit %C), werden Werte im Bereich [69, 99] als Jahre 1969 bis 1999 und Werte im Bereich [00, 68] als Jahre 2000 bis 2068 angenommen. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Die modifizierten Befehle %Ey und %Oy interpretieren die alternative Darstellung der Locale.
%Y %NY %EY	Parst das Jahr als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 4. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %EY interpretiert die alternative Darstellung der Locale.
Monat
%b %B %h	Parst den vollen oder abgekürzten, nicht Groß-/Kleinschreibung berücksichtigenden Monatsnamen der Locale.
%m %Nm %Om	Parst den Monat als Dezimalzahl (Januar ist 1). Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %Om interpretiert die alternative Darstellung der Locale.
Tag
%d %Nd %Od %e %Ne %Oe	Parst den Tag des Monats als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Die modifizierten Befehle %Od und %Oe interpretieren die alternative Darstellung der Locale.
Wochentag
%a %A	Parst den vollen oder abgekürzten, nicht Groß-/Kleinschreibung berücksichtigenden Wochentagsnamen der Locale.
%u %Nu	Parst den ISO-Wochentag als Dezimalzahl (1-7), wobei Montag 1 ist. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 1. Führende Nullen sind erlaubt, aber nicht erforderlich.
%w %Nw %Ow	Parst den Wochentag als Dezimalzahl (0-6), wobei Sonntag 0 ist. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 1. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %Ow interpretiert die alternative Darstellung der Locale.
ISO 8601 wochenbasierendes Jahr
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
%g %Ng	Parst die letzten zwei Dezimalziffern des ISO 8601 wochenbasierten Jahres. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich.
%G %NG	Parst das ISO 8601 wochenbasierte Jahr als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 4. Führende Nullen sind erlaubt, aber nicht erforderlich.
%V %NV	Parst die ISO 8601-Kalenderwoche des Jahres als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich.
Woche/Tag des Jahres
%j %Nj	Parst den Tag des Jahres als Dezimalzahl (1. Januar ist 1). Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 3. Führende Nullen sind erlaubt, aber nicht erforderlich.
%U %NU %OU	Parst die Wochennummer des Jahres als Dezimalzahl. Der erste Sonntag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres vor diesem sind in Woche 00. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OU interpretiert die alternative Darstellung der Locale.
%W %NW %OW	Parst die Wochennummer des Jahres als Dezimalzahl. Der erste Montag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres vor diesem sind in Woche 00. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OW interpretiert die alternative Darstellung der Locale.
Datum
%D	Entspricht "%m/%d/%y".
%F %NF	Entspricht "%Y-%m-%d". Wenn die Breite angegeben ist, wird sie nur auf %Y angewendet.
%x %Ex	Parst die Datumsdarstellung der Locale. Der modifizierte Befehl %Ex interpretiert die alternative Datumsdarstellung der Locale.
Tageszeit
%H %NH %OH	Parst die Stunde (24-Stunden-Format) als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OH interpretiert die alternative Darstellung der Locale.
%I %NI %OI	Parst die Stunde (12-Stunden-Format) als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OI interpretiert die alternative Darstellung der Locale.
%M %NM %OM	Parst die Minute als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OM interpretiert die alternative Darstellung der Locale.
%S %NS %OS	Parst die Sekunde als Dezimalzahl. Die Breite N gibt die maximale Anzahl der zu lesenden Zeichen an. Die Standardbreite ist 2. Führende Nullen sind erlaubt, aber nicht erforderlich. Der modifizierte Befehl %OS interpretiert die alternative Darstellung der Locale.
%p	Parst die entsprechende AM/PM-Bezeichnung der Locale, die mit einer 12-Stunden-Uhr assoziiert ist.
%R	Entspricht "%H:%M".
%T	Entspricht "%H:%M:%S".
%r	Parst die 12-Stunden-Uhrzeit der Locale.
%X %EX	Parst die Zeitdarstellung der Locale. Der modifizierte Befehl %EX interpretiert die alternative Zeitdarstellung der Locale.
Sonstiges
%c %Ec	Parst die Datums- und Zeitdarstellung der Locale. Der modifizierte Befehl %Ec interpretiert die alternative Datums- und Zeitdarstellung der Locale.
%z %Ez %Oz	Parst den Offset von UTC im Format [+|-]hh[mm]. Zum Beispiel bezieht sich -0430 auf 4 Stunden und 30 Minuten hinter UTC, und 04 bezieht sich auf 4 Stunden vor UTC. Die modifizierten Befehle %Ez und %Oz parsen das Format [+|-]h[h][:mm] (d. h., sie erfordern einen : zwischen Stunden und Minuten und machen die führende Null für Stunden optional).
%Z	Parst die Zeitzonenabkürzung oder den Zeitzonennamen, genommen als die längste Sequenz von Zeichen, die nur die Zeichen A bis Z, a bis z, 0 bis 9, -, +, _ und / enthält.

Rückgabewert

ist

Siehe auch

parse (C++20)

parst ein chrono Objekt aus einem Stream (Funktions-Template)