std:: formatter <std::chrono::duration>

Especialización de std::formatter que define reglas de formato para una std::chrono::duration . La duration se interpreta como la hora del día desde la medianoche.

La especialización de std::formatter normalmente no se accede directamente, sino que se utiliza a través de funciones de formato .

Especificación de formato

La especificación de formato tiene la forma

fill-and-align , width , y precision tienen el mismo significado que en la especificación de formato estándar . precision es válida solo para tipos std::chrono::duration donde el tipo de representación Rep es un tipo de punto flotante; de lo contrario, se lanza std::format_error .

La configuración regional utilizada para el formato se determina de la siguiente manera:

• la configuración regional predeterminada "C" si L no está presente en la especificación de formato,
• de lo contrario, la configuración regional denotada por el std::locale pasado a la función de formato, si existe alguno,
• de lo contrario ( L está presente pero no se pasa ningún std::locale a la función de formato), la configuración regional global.

Si la codificación de literal de cadena (ordinaria o ancha) es una forma de codificación Unicode y la configuración regional se encuentra entre un conjunto definido por la implementación de configuraciones regionales, cada reemplazo que depende de la configuración regional se realiza como si la secuencia de caracteres de reemplazo se convirtiera a la codificación literal.

La chrono-spec consiste en uno o más especificadores de conversión y caracteres ordinarios (distintos de { , } , y % ). Una chrono-spec debe comenzar con un especificador de conversión. Todos los caracteres ordinarios se escriben en la salida sin modificación. Cada especificador de conversión no modificado comienza con un carácter % seguido de un carácter que determina el comportamiento del especificador. Algunos especificadores de conversión tienen una forma modificada en la que se inserta un carácter modificador E o O después del carácter % . Cada especificador de conversión se reemplaza por los caracteres apropiados en la salida como se describe a continuación.

A menos que se especifique lo contrario, si el chrono-spec está vacío, el objeto chrono se formatea como si se transmitiera a un objeto os de tipo std:: basic_ostringstream < CharT > con la configuración regional de formato (una de std:: locale :: classic ( ) , el objeto std::locale pasado, y std:: locale :: global ( ) ) establecida y copiando os. str ( ) al búfer de salida con relleno adicional y ajustes según los especificadores de formato.

Los siguientes especificadores de formato están disponibles:

Los siguientes especificadores son reconocidos, pero causarán que se lance std::format_error :

Ejemplo

#include <chrono>
#include <print>
using namespace std::chrono_literals;
int main()
{
    auto du{3h + 2min + 1s};
    std::print(
        "Duration is:\n"
        "{}\n"
        "{:%T}\n"
        "{:%H:%M:%S}\n"
        "{:%H hours %M minutes %S seconds}\n",
        du, du, du, du);
}

Duration is:
10921s
03:02:01
03:02:01
03 hours 02 minutes 01 seconds

Véase también