std:: formatter <std::chrono::sys_time>

Spezialisierung von std::formatter , die Formatierungsregeln für einen std::chrono::sys_time definiert.

• Wenn %Z verwendet wird, wird es durch "UTC" ersetzt und auf CharT erweitert.
• Wenn %z oder eine modifizierte Variante davon verwendet wird, wird ein Offset von 0min formatiert.

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

Formatspezifikation

Die Formatspezifikation hat die Form

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

Das für die Formatierung verwendete Gebietsschema wird wie folgt bestimmt:

• die Standard-Lokalisierung "C" falls L nicht in der Formatangabe vorhanden ist,
• andernfalls die durch das std::locale bezeichnete Lokalisierung, falls eine an die Formatierungsfunktion übergeben wurde,
• andernfalls ( L ist vorhanden, aber kein std::locale wurde an die Formatierungsfunktion übergeben) die globale Lokalisierung.

Wenn die (gewöhnliche oder breite) String-Literal-Kodierung eine Unicode-Kodierungsform ist und das Gebietsschema zu einem implementierungsdefinierten Satz von Gebietsschemata gehört, wird jeder ersetzende Vorgang, der vom Gebietsschema abhängt, so durchgeführt, als ob die Ersatzzeichenfolge in die Literalkodierung 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 unmodifizierte 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. Jeder Konvertierungsspezifizierer wird wie unten beschrieben durch entsprechende Zeichen in der Ausgabe ersetzt.

Sofern nicht anders angegeben, wird das Chrono-Objekt, wenn die chrono-spec leer ist, so formatiert, als würde es durch Streamen an ein Objekt os vom Typ std:: basic_ostringstream < CharT > mit der Formatierungs-Locale (entweder std:: locale :: classic ( ) , das übergebene std::locale -Objekt oder std:: locale :: global ( ) ) eingestellt und os. str ( ) in den Ausgabepuffer kopiert, mit zusätzlichem Auffüllen und Anpassungen gemäß den Format-Spezifizierern.

Die folgenden Formatbezeichner sind verfügbar:

Die folgenden Spezifizierer werden erkannt, führen jedoch dazu, dass std::format_error ausgelöst wird:

Beispiel

#include <chrono>
#include <format>
#include <iostream>
int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
    std::cout << std::format("The time of the Unix epoch was {0:%F}T{0:%R%z}.", epoch)
              << '\n';
}

The time of the Unix epoch was 1970-01-01T00:00+0000.

Fehlerberichte

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

Siehe auch