std::chrono:: from_stream (std::chrono::tai_time)

template < class CharT, class Traits, class Duration, class Alloc = std:: allocator < CharT > > std:: basic_istream < CharT, Traits > & from_stream ( std:: basic_istream < CharT, Traits > & is, const CharT * fmt, std:: chrono :: tai_time < Duration > & tp, std:: basic_string < CharT, Traits, Alloc > * abbrev = nullptr, std:: chrono :: minutes * offset = nullptr ) ;		(desde C++20)

Intenta analizar el flujo de entrada is en el punto temporal tp de acuerdo con la cadena de formato fmt .

Se comporta como una UnformattedInputFunction , excepto que tiene un efecto no especificado en is. gcount ( ) . Después de construir y verificar el objeto centinela, intenta analizar el flujo de entrada is en tp de acuerdo con la cadena de formato fmt . Si el análisis no logra decodificar un punto temporal válido, is. setstate ( std:: ios_base :: failbit ) es llamado y tp no es modificado.

Si el especificador de formato %Z se utiliza y se analiza exitosamente, el valor analizado se asigna a * abbrev si abbrev no es nulo. Si el especificador de formato %z o una variante modificada se utiliza y se analiza exitosamente, el valor analizado se asigna a * offset si offset no es nulo, y el offset analizado se restará del timestamp analizado antes de que la diferencia se asigne a tp .

Contenidos 1 Parámetros 2 Cadena de formato 3 Valor de retorno 4 Ejemplo 5 Véase también

Parámetros

is	-	un flujo de entrada
fmt	-	una cadena de formato (ver abajo)
tp	-	objeto de punto temporal para contener el resultado del análisis
abbrev	-	si no es nulo, puntero a un objeto que contendrá la abreviatura o nombre de la zona horaria correspondiente al %Z especificador
offset	-	si no es nulo, puntero a un objeto que contendrá el desplazamiento desde UTC correspondiente al %z especificador

Cadena de formato

La cadena de formato consiste en cero o más especificadores de conversión y caracteres ordinarios. Cada carácter ordinario, excluyendo los caracteres de espacio en blanco y el carácter nulo de terminación, coincide con un carácter idéntico del flujo de entrada, o causa que la función falle si el siguiente carácter en el flujo no es igual al comparar.

Cada carácter de espacio en blanco coincide con cero o más caracteres de espacio en blanco en el flujo de entrada.

Cada especificador de conversión sin modificar comienza con un % seguido de un carácter que determina el comportamiento del especificador. Algunos especificadores de conversión tienen una forma modificada en la que un carácter modificador E o O se inserta después del carácter % . Algunos especificadores de conversión tienen una forma modificada en la que un parámetro de ancho dado como un entero decimal positivo (mostrado como N abajo) se inserta después del carácter % . Cada especificador de conversión hace que los caracteres coincidentes se interpreten como partes de tipos de fecha y hora según la tabla siguiente.

Una secuencia de caracteres en la cadena de formato que comienza con un % pero no coincide con uno de los especificadores de conversión a continuación se interpreta como caracteres ordinarios.

Si from_stream no logra analizar todo lo especificado por la cadena de formato, o si se analiza información insuficiente para especificar un resultado completo, o si el análisis revela información contradictoria, is. setstate ( std:: ios_base :: failbit ) es llamado.

Los siguientes especificadores de conversión están disponibles:

Especificador de conversión	Explicación
%%	Coincide con un carácter % literal.
%n	Coincide con un carácter de espacio en blanco.
%t	Coincide con cero o un carácter de espacio en blanco.
Año
%C % N C %EC	Analiza el siglo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %EC interpreta la representación alternativa del siglo según la configuración regional.
%y % N y %Ey %Oy	Analiza los dos últimos dígitos decimales del año. Si el siglo no se especifica de otra manera (por ejemplo, con %C), se presume que los valores en el rango [69, 99] se refieren a los años 1969 a 1999, y los valores en el rango [00, 68] se refieren a los años 2000 a 2068. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. Los comandos modificados %Ey y %Oy interpretan la representación alternativa de la configuración regional.
%Y % N Y %EY	Analiza el año como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 4. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %EY interpreta la representación alternativa de la configuración regional.
Mes
%b %B %h	Analiza el nombre completo o abreviado del mes, sin distinción entre mayúsculas y minúsculas, según la configuración regional.
%m % N m %Om	Analiza el mes como un número decimal (enero es 1 ). El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros iniciales pero no son obligatorios. El comando modificado %Om interpreta la representación alternativa de la configuración regional.
Día
%d % N d %Od %e % N e %Oe	Analiza el día del mes como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. Los comandos modificados %Od y %Oe interpretan la representación alternativa de la configuración regional.
Día de la semana
%a %A	Analiza el nombre completo o abreviado del día de la semana, sin distinción entre mayúsculas y minúsculas, según la configuración regional.
%u % N u	Analiza el día de la semana ISO como un número decimal (1-7), donde el lunes es 1 . El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 1. Se permiten ceros a la izquierda pero no son obligatorios.
%w % N w %Ow	Interpreta el día de la semana como un número decimal (0-6), donde el domingo es 0 . El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 1. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %Ow interpreta la representación alternativa de la configuración regional.
Año basado en semanas ISO 8601
En la norma ISO 8601 las semanas comienzan el lunes y la primera semana del año debe cumplir los siguientes requisitos: Incluye el 4 de enero Incluye el primer jueves del año
%g % N g	Analiza los dos últimos dígitos decimales del año basado en semanas ISO 8601. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.
%G % N G	Analiza el año basado en semanas ISO 8601 como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 4. Se permiten ceros a la izquierda pero no son obligatorios.
%V % N V	Analiza la semana ISO 8601 del año como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios.
Semana/día del año
%j % N j	Analiza el día del año como un número decimal (1 de enero es 1 ). El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 3. Se permiten ceros a la izquierda pero no son obligatorios.
%U % N U %OU	Analiza el número de semana del año como un número decimal. El primer domingo del año es el primer día de la semana 01. Los días del mismo año anteriores a ese están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OU interpreta la representación alternativa de la configuración regional.
%W % N W %OW	Analiza el número de la semana del año como un número decimal. El primer lunes del año es el primer día de la semana 01. Los días del mismo año anteriores a ese están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OW interpreta la representación alternativa de la configuración regional.
Fecha
%D	Equivalente a "%m/%d/%y" .
%F % N F	Equivalente a "%Y-%m-%d" . Si se especifica el ancho, solo se aplica al %Y .
%x %Ex	Analiza la representación de fecha de la configuración regional. El comando modificado %Ex interpreta la representación de fecha alternativa de la configuración regional.
Hora del día
%H % N H %OH	Analiza la hora (reloj de 24 horas) como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OH interpreta la representación alternativa de la configuración regional.
%I % N I %OI	Analiza la hora (reloj de 12 horas) como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OI interpreta la representación alternativa de la configuración regional.
%M % N M %OM	Analiza el minuto como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2. Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OM interpreta la representación alternativa de la configuración regional.
%S % N S %OS	Analiza el segundo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho predeterminado es 2 si Duration es convertible a std::chrono::seconds , de lo contrario se determina por la precisión decimal de Duration y el campo se interpreta como un long double en formato fijo, con el carácter de punto decimal determinado por la configuración regional (si se encuentra). Se permiten ceros a la izquierda pero no son obligatorios. El comando modificado %OS interpreta la representación alternativa de la configuración regional.
%p	Analiza los equivalentes regionales de las designaciones AM/PM asociadas con un reloj de 12 horas.
%R	Equivalente a "%H:%M" .
%T	Equivalente a "%H:%M:%S" .
%r	Analiza la hora del reloj de 12 horas de la configuración regional.
%X %EX	Analiza la representación de hora de la configuración regional. El comando modificado %EX interpreta la representación de hora alternativa de la configuración regional.
Miscelánea
%c %Ec	Analiza la representación de fecha y hora de la configuración regional. El comando modificado %Ec interpreta la representación alternativa de fecha y hora de la configuración regional.
%z %Ez %Oz	Analiza el desplazamiento de UTC en el formato [+|-]hh[mm] . Por ejemplo, -0430 se refiere a 4 horas 30 minutos detrás de UTC y 04 se refiere a 4 horas adelante de UTC. Los comandos modificados %Ez y %Oz analizan el formato [+|-]h[h][:mm] (es decir, requieren un : entre las horas y los minutos y hacen opcional el cero inicial para la hora).
%Z	Analiza la abreviatura o nombre de la zona horaria, tomada como la secuencia más larga de caracteres que solo contiene los caracteres A a Z , a a z , 0 a 9 , - , + , _ , y / .

Valor de retorno

is

Ejemplo

Esta sección está incompleta Razón: sin ejemplo

Véase también

parse (C++20)

analiza un objeto chrono desde un flujo (plantilla de función)