std:: formatter <std::chrono::utc_time>

Spécialisation de std::formatter qui définit les règles de formatage pour un std::chrono::utc_time .

• Si %Z est utilisé, il est remplacé par "UTC" élargi en CharT .
• Si %z ou une variante modifiée est utilisée, un décalage de 0min sera formaté.
• Si l'argument représente un temps durant une insertion de seconde intercalaire et qu'un champ de secondes est formaté, la partie intégrale du champ est "60" élargie en CharT .

La spécialisation std::formatter n'est généralement pas accédée directement, mais est utilisée via les fonctions de formatage .

Spécification du format

La spécification de format a la forme

fill-and-align , width , et precision ont la même signification que dans la spécification de format standard . precision n'est valide que pour les types std::chrono::duration où le type de représentation Rep est un type à virgule flottante, sinon std::format_error est levée.

La locale utilisée pour le formatage est déterminée comme suit :

• la locale par défaut "C" si L n'est pas présente dans la spécification de format,
• sinon, la locale désignée par le std::locale passé à la fonction de formatage, s'il y en a un,
• sinon ( L est présent mais aucun std::locale n'est passé à la fonction de formatage), la locale globale.

Si l' encodage des littéraux de chaîne (ordinaire ou large) est une forme de codage Unicode et que la locale fait partie d'un ensemble défini par l'implémentation de locales, chaque remplacement dépendant de la locale est effectué comme si la séquence de caractères de remplacement était convertie vers l'encodage du littéral.

La chrono-spec consiste en un ou plusieurs spécificateurs de conversion et des caractères ordinaires (autres que { , } , et % ). Une chrono-spec doit commencer par un spécificateur de conversion. Tous les caractères ordinaires sont écrits en sortie sans modification. Chaque spécificateur de conversion non modifié commence par un caractère % suivi d'un caractère qui détermine le comportement du spécificateur. Certains spécificateurs de conversion ont une forme modifiée dans laquelle un caractère modificateur E ou O est inséré après le caractère % . Chaque spécificateur de conversion est remplacé par les caractères appropriés en sortie comme décrit ci-dessous.

Sauf indication contraire, si le chrono-spec est vide, l'objet chrono est formaté comme s'il était streamé vers un objet os de type std:: basic_ostringstream < CharT > avec la locale de formatage (l'une de std:: locale :: classic ( ) , l'objet std::locale passé, et std:: locale :: global ( ) ) appliquée et en copiant os. str ( ) vers le tampon de sortie avec un remplissage et des ajustements supplémentaires selon les spécificateurs de format.

Les spécificateurs de format suivants sont disponibles :

Les spécificateurs suivants sont reconnus, mais entraîneront std::format_error à être levé :

Exemple

#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.

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi