std::formatter<std::chrono::hh_mm_ss>

 

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::hh_mm_ss

Memberfunktionen

hh_mm_ss::hh_mm_ss

hh_mm_ss::is_negativehh_mm_ss::hourshh_mm_ss::minuteshh_mm_ss::secondshh_mm_ss::subseconds

hh_mm_ss::operator precisionhh_mm_ss::to_duration

Nicht-Member-Funktionen

operator<<

Hilfsklassen

formatter<std::chrono::hh_mm_ss>

 

Definiert in Header <chrono>
template< class CharT > struct formatter<std::chrono::hh_mm_ss, CharT>;		(seit C++20)

Spezialisierung von std::formatter, die Formatierungsregeln für eine std::chrono::hh_mm_ss definiert.

Die std::formatter-Spezialisierung wird normalerweise nicht direkt aufgerufen, sondern über Formatierungsfunktionen verwendet.

Formatierungsangabe

Die Formatangabe hat die Form

fill-and-align (optional) width (optional) precision (optional) L(optional) chrono-spec (optional)

fill-and-align, width und precision haben die gleiche Bedeutung wie in der Standardformatangabe. precision ist nur für std::chrono::duration-Typen gültig, deren Repräsentationstyp Rep ein Gleitkommatyp ist, andernfalls wird std::format_error ausgelöst.

Das zur Formatierung verwendete Gebietsschema wird wie folgt bestimmt

• das Standard-"C"-Gebietsschema, wenn L nicht in der Formatangabe enthalten ist,
• andernfalls das Gebietsschema, das durch das an die Formatierungsfunktion übergebene std::locale bezeichnet wird, falls vorhanden,
• andernfalls (L ist vorhanden, aber keine std::locale wird an die Formatierungsfunktion übergeben), das globale Gebietsschema.

Wenn die Kodierung des (gewöhnlichen oder breiten) Zeichenkettenliterals eine Unicode-Kodierungsform ist und das Gebietsschema zu einer implementierungsdefinierten Menge von Gebietsschemata gehört, werden jede Ersetzung, die vom Gebietsschema abhängt, so durchgeführt, als ob die Ersetzungszeichenfolge in die Literal-Kodierung konvertiert würde.

Die chrono-spec besteht aus einem oder mehreren Konvertierungsspezifizierern und gewöhnlichen Zeichen (außer {, } und %). Eine chrono-spec muss mit einem Konvertierungsspezifizierer beginnen. Alle gewöhnlichen Zeichen werden unverändert in die Ausgabe geschrieben. 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 nach dem %-Zeichen ein E- oder O-Modifikatorzeichen eingefügt wird. Jeder Konvertierungsspezifizierer wird durch die unten beschriebenen entsprechenden Zeichen in der Ausgabe ersetzt.

Sofern nicht anders angegeben, wird, wenn die chrono-spec leer ist, das Chrono-Objekt formatiert, als ob es mit gestreamt auf ein Objekt os vom Typ std::basic_ostringstream<CharT> formatiert wäre, das mit der Formatierungs-Locale (eine von std::locale::classic(), dem übergebenen std::locale-Objekt und std::locale::global()) imbuiert wurde und das Kopieren von os.str() in den Ausgabepuffer mit zusätzlicher Auffüllung und Anpassungen gemäß den Formatierungsangaben.

Die folgenden Format-Spezifizierer sind verfügbar:

Konversion Spezifizierer	Erklärung
%%	Schreibt ein literales %-Zeichen.
%n	Schreibt ein Zeilenumbruchzeichen.
%t	Schreibt ein horizontalen Tabulator.
Tageszeit
%H %OH	Schreibt die Stunde (24-Stunden-Format) als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OH schreibt die alternative Darstellung des Gebietsschemas.
%I %OI	Schreibt die Stunde (12-Stunden-Format) als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OI schreibt die alternative Darstellung des Gebietsschemas.
%M %OM	Schreibt die Minute als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OM schreibt die alternative Darstellung des Gebietsschemas.
%S %OS	Schreibt die Sekunde als Dezimalzahl. Wenn die Anzahl der Sekunden kleiner als 10 ist, wird das Ergebnis mit 0 vorangestellt. Wenn die Präzision der Eingabe nicht exakt mit Sekunden dargestellt werden kann, ist das Format eine Dezimalzahl mit Festkommaformat und einer Präzision, die der Präzision der Eingabe entspricht (oder einer Mikrosekundenpräzision, wenn die Konvertierung in Dezimalsekunden mit Gleitkommazahl nicht innerhalb von 18 Nachkommastellen erfolgen kann). Das Dezimaltrennzeichen wird gemäß dem Gebietsschema lokalisiert. Der modifizierte Befehl %OS schreibt die alternative Darstellung des Gebietsschemas.
%p	Schreibt die Bezeichnung für AM/PM des Gebietsschemas für eine 12-Stunden-Uhr.
%R	Entspricht "%H:%M".
%T	Entspricht "%H:%M:%S".
%r	Schreibt die 12-Stunden-Uhrzeit des Gebietsschemas.
%X %EX	Schreibt die Zeitdarstellung des Gebietsschemas. Der modifizierte Befehl %EX schreibt die alternative Zeitdarstellung des Gebietsschemas.

Die folgenden Spezifizierer werden erkannt, führen aber zu einem std::format_error-Fehler

Konversion Spezifizierer	Erklärung
Jahr
%C %EC	Schreibt das Jahr geteilt durch 100 mittels abgerundeter Division. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %EC schreibt die alternative Darstellung des Jahrhunderts des Gebietsschemas.
%y %Oy %Ey	Schreibt die letzten beiden Dezimalziffern des Jahres. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %Oy schreibt die alternative Darstellung des Gebietsschemas. Der modifizierte Befehl %Ey schreibt die alternative Darstellung des Offsets vom %EC (nur das Jahr) des Gebietsschemas.
%Y %EY	Schreibt das Jahr als Dezimalzahl. Wenn das Ergebnis weniger als vier Ziffern hat, wird es mit Nullen auf vier Ziffern aufgefüllt. Der modifizierte Befehl %EY schreibt die alternative vollständige Jahresdarstellung des Gebietsschemas.
Monat
%b %h	Schreibt den abgekürzten Monatsnamen des Gebietsschemas.
%B	Schreibt den vollständigen Monatsnamen des Gebietsschemas.
%m %Om	Schreibt den Monat als Dezimalzahl (Januar ist 01). Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %Om schreibt die alternative Darstellung des Gebietsschemas.
Tag
%d %Od	Schreibt den Tag des Monats als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %Od schreibt die alternative Darstellung des Gebietsschemas.
%e %Oe	Schreibt den Tag des Monats als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit einem Leerzeichen vorangestellt. Der modifizierte Befehl %Oe schreibt die alternative Darstellung des Gebietsschemas.
Wochentag
%a	Schreibt den abgekürzten Wochentagsnamen des Gebietsschemas.
%A	Schreibt den vollständigen Wochentagsnamen des Gebietsschemas.
%u %Ou	Schreibt den ISO-Wochentag als Dezimalzahl (1-7), wobei Montag 1 ist. Der modifizierte Befehl %Ou schreibt die alternative Darstellung des Gebietsschemas.
%w %Ow	Schreibt den Wochentag als Dezimalzahl (0-6), wobei Sonntag 0 ist. Der modifizierte Befehl %Ow schreibt die alternative Darstellung des Gebietsschemas.
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	Schreibt die letzten beiden Dezimalziffern des ISO 8601 wochenbasierten Jahres. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt.
%G	Schreibt das ISO 8601 wochenbasierte Jahr als Dezimalzahl. Wenn das Ergebnis weniger als vier Ziffern hat, wird es mit Nullen auf vier Ziffern aufgefüllt.
%V %OV	Schreibt die ISO 8601 Kalenderwoche des Jahres als Dezimalzahl. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OV schreibt die alternative Darstellung des Gebietsschemas.
Woche/Tag des Jahres
%j	Schreibt den Tag des Jahres als Dezimalzahl (1. Januar ist 001). Wenn das Ergebnis weniger als drei Ziffern hat, wird es mit Nullen auf drei Ziffern aufgefüllt.
%U %OU	Schreibt die Kalenderwoche als Dezimalzahl. Der erste Sonntag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres davor gehören zur Woche 00. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OU schreibt die alternative Darstellung des Gebietsschemas.
%W %OW	Schreibt die Kalenderwoche als Dezimalzahl. Der erste Montag des Jahres ist der erste Tag der Woche 01. Tage desselben Jahres davor gehören zur Woche 00. Wenn das Ergebnis einstellig ist, wird es mit 0 vorangestellt. Der modifizierte Befehl %OW schreibt die alternative Darstellung des Gebietsschemas.
Datum
%D	Entspricht "%m/%d/%y".
%F	Entspricht "%Y-%m-%d".
%x %Ex	Schreibt die Datumsdarstellung des Gebietsschemas. Der modifizierte Befehl %Ex erzeugt die alternative Datumsdarstellung des Gebietsschemas.
Anzahl der Ticks der Dauer
%Q	Schreibt die Anzahl der Ticks der Dauer, d.h. den Wert, der über count() erhalten wird.
%q	Schreibt das Einheitensuffix der Dauer, wie in operator<<() angegeben.
Zeitzone
%z %Ez %Oz	Schreibt den Offset von UTC im ISO 8601-Format. Zum Beispiel bezieht sich -0430 auf 4 Stunden und 30 Minuten hinter UTC. Wenn der Offset null ist, wird +0000 verwendet. Die modifizierten Befehle %Ez und %Oz fügen einen Doppelpunkt : zwischen Stunden und Minuten ein (z. B. -04:30).
%Z	Schreibt die Zeitzonenabkürzung.
Sonstiges
%c %Ec	Schreibt die Datums- und Zeitdarstellung des Gebietsschemas. Der modifizierte Befehl %Ec schreibt die alternative Datums- und Zeitdarstellung des Gebietsschemas.

Beispiel

Führen Sie diesen Code aus

#include <chrono>
#include <format>
#include <iostream>
using namespace std::literals;
 
int main()
{
    std::chrono::hh_mm_ss c{16h + 32min + 10s};
 
    std::cout << "%R: " << std::format("{:%R}", c) << '\n'
              << "%T: " << std::format("{:%T}", c) << '\n';
}

Ausgabe

%R: 16:32
%T: 16:32:10

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
P2372R3	C++20	formatter verwendete das globale Locale oder ein übergebenes Locale	Standard-"C"-Locale wird verwendet, wenn L fehlt

Siehe auch

format (C++20)

speichert die formatierte Darstellung der Argumente in einem neuen String (Funktionstemplate)