std::chrono::from_stream (std::chrono::file_time)

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica(C++20) Servicios del programa Apoyo de corrutinas(C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits(C++20) bitset hash (C++11) Operadores relacionales(en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Utilerías de fecha y hora

Punto de tiempo
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
Duración
duration (C++11)
Relojes
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11)	is_clock (C++20) utc_clock (C++20) tai_clock (C++20)	gps_clock (C++20) file_clock (C++20) local_t (C++20)
Hora del día
is_amis_pm (C++20)(C++20)	make12make24 (C++20)(C++20)	hh_mm_ss (C++20)
Calendario
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)
Zona horaria
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)
E/S de chrono
parse (C++20)
Fecha y hora estilo C

 

std::chrono::file_clock

Funciones miembro

file_clock::now

file_clock::to_sysfile_clock::from_sys (solo se proporciona si to_utc y from_utc no se proporcionan)

file_clock::to_utcfile_clock::from_utc (solo se proporciona si to_sys y from_sys no se proporcionan)

E/S de puntos de tiempo

operator<<

formatter<std::chrono::file_time>

from_stream

 

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::file_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 de tiempo tp según la cadena de formato fmt.

Se comporta como 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 según la cadena de formato fmt. Si el análisis no logra decodificar un punto de tiempo válido, se llama a is.setstate(std::ios_base::failbit) y tp no se modifica.

Si se usa el especificador de formato %Z y se analiza correctamente, el valor analizado se asigna a *abbrev si abbrev no es nulo. Si se utiliza el especificador de formato %z o una variante modificada y se analiza correctamente, el valor analizado se asigna a *offset si offset no es nulo{{# ifeq:file_time|local_time||, y el desplazamiento analizado se restará de la marca de tiempo analizada antes de que la diferencia se asigne a tp}}.

Parámetros

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

Cadena de formato

La cadena de formato consta de cero o más especificadores de conversión y caracteres ordinarios. Cada carácter ordinario, excepto los espacios en blanco y el carácter nulo de terminación, coincide con un carácter idéntico del flujo de entrada o hace que la función falle si el siguiente carácter en el flujo no se compara igual.

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 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 u O después del carácter %. Algunos especificadores de conversión tienen una forma modificada en la que se da un parámetro ancho como un entero decimal positivo (que se muestra como N a continuación) se inserta después del carácter %. Cada especificador de conversión hace que los caracteres coincidentes se interpreten como partes de los tipos de fecha y hora según la tabla siguiente.

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

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

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

Especificador de conversión	Explicación
%%	Coincide con un literal de carácter %.
%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 %NC %EC	Analiza el siglo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %EC interpreta la representación alternativa del siglo de la configuración regional.
%y %Ny %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 supone 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 supone que se refieren a los años 2000 a 2068. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. Los comandos modificados %Ey y %Oy interpretan la representación alternativa de la configuración regional.
%Y %NY %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 por defecto es 4. Los ceros iniciales están permitidos 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 del mes completo o abreviado de la configuración regional, sin distinguir entre mayúsculas y minúsculas.
%m %Nm %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 por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %Om interpreta la representación alternativa de la configuración regional.
Día
%d %Nd %Od %e %Ne %Oe	Analiza el mes del mes como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos 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 de mayúsculas y minúsculas de la configuración regional.
%u %Nu	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 por defecto es 1. Los ceros iniciales están permitidos pero no son obligatorios.
%w %Nw %Ow	Analiza 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 por defecto es 1. Los ceros iniciales están permitidos 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 ISO 8601 las semanas comienzan con el lunes y la primera semana del año debe cumplir los siguientes requisitos: Incluye 4 de enero. Incluye primer jueves del año.
%g %Ng	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 por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios.
%G %NG	Analiza el año ISO 8601 basado en semanas como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 4. Los ceros iniciales están permitidos pero no son obligatorios.
%V %NV	Analiza la semana del año ISO 8601 como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios.
Semana/día del año
%j %Nj	Analiza el día del año como un número decimal (January 1 is 1). El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 3. Los ceros iniciales están permitidos pero no son obligatorios.
%U %NU %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 al primer domingo están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %OU interpreta la representación alternativa de la configuración regional.
%W %NW %OW	Analiza el número de 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 al primer lunes están en la semana 00. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos 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 %NF	Equivalente a "%Y-%m-%d". Si se especifica el ancho, solo se aplica a %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 %NH %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 por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %OH interpreta la representación alternativa de la configuración regional.
%I %NI %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 por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %OI interpreta la representación alternativa de la configuración regional.
%M %NM %OM	Analiza el minuto como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2. Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %OM interpreta la representación alternativa de la configuración regional.
%S %NS %OS	Analiza el segundo como un número decimal. El ancho N especifica el número máximo de caracteres a leer. El ancho por defecto es 2 si Duration es convertible a std::chrono::seconds, de lo contrario, está determinado por la precisión decimal de Duration y el campo se interpreta como un longdouble en un formato fijo, con el carácter de punto decimal determinado por la configuración regional (si se encuentra). Los ceros iniciales están permitidos pero no son obligatorios. El comando modificado %OS interpreta la representación alternativa de la configuración regional.
%p	Analiza el equivalente de la configuración regional 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 día del reloj de 12 horas de la configuración regional.
%X %EX	Analiza la representación de la hora del día de la configuración regional. El comando modificado %EX interpreta la representación alternativa de la hora del día de la configuración regional.
Misceláneos
%c %Ec	Analiza la representación de fecha y hora de la configuración regional. El comando modificado %Ec interpreta la representación 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 delante de UTC. Los comandos modificados %Ez y %Oz analizan el formato [+|-]h[h][:mm] (es decir, requieren un carácter : entre las horas y los minutos y hacen que el cero inicial para la hora sea opcional).
%Z	Analiza la abreviatura o el nombre del huso horario, tomado como la secuencia más larga de caracteres que solo contiene los caracteres de la A a la Z, de la a a la z, del 0 al 9, -, +, _ y /.

Valor de retorno

is.

Véase también

parse (C++20)

Analiza un objeto chrono a partir de un flujo (plantilla de función)