<chrono>

Incluya el encabezado estándar <chrono> para definir las clases y funciones que representan y manipulan las duraciones de tiempo e instantes de tiempo.

Desde Visual Studio 2015, la implementación de steady_clock ha cambiado para cumplir los requisitos del estándar de C++ en cuanto a estabilidad y monotonía:

• steady_clock ahora se basa en QueryPerformanceCounter()
• high_resolution_clock ahora es una definición de tipo de steady_clock. En la implementación de Microsoft C++, steady_clock::time_point ahora es un typedef de chrono::time_point<steady_clock>. Sin embargo, esto no es necesariamente el caso de otras implementaciones.

Requisitos

Encabezado: <chrono>

En ocasiones, los legisladores regionales realizan cambios en las zonas horarias, y un organismo internacional de estándares especifica cuándo se deben tener en cuenta nuevos segundos intercalares. Se agregó una base de datos de estos cambios a Windows 10. Específicamente:

Característica	Versión del cliente	Versión del servidor
Actualizaciones de la base de datos de segundos intercalares	Windows 10, versión 1809 o posterior	Windows Server 2019 o posterior
Compatibilidad con zonas horarias	Windows 10, versión 1903/19H1 o posterior	Windows Server 2022 o posterior

El uso de las instalaciones de zona horaria en versiones anteriores de Windows produce un error en tiempo de ejecución.

Espacio de nombres: std

Tipos calendáricos

Nombre	Descripción
Estructura common_type	Describe especializaciones de la plantilla de clase common_type para las creaciones de instancias de duration y time_point.
Clase day	Día del mes. Por ejemplo, el día 25 del mes.
Clase duration	Intervalo de tiempo.
Estructura duration_values	Proporciona valores concretos para el parámetro Rep de plantilla duration.
Clase hh_mm_ss	Divide duration en horas:minutos:segundos.
last_spec	Se usa para indicar el último elemento de un mes, como el último día de la semana de un mes (el último martes de febrero de 2020) o el último día de un mes (el último día de abril de 2019).
Clase leap_second	Fecha y valor de un segundo intercalar insertado.
Estructura leap_second_info	Datos devueltos por get_leap_second_info.
Clase month	Mes de un año. Por ejemplo, julio.
Clase month_day	Día específico de un mes específico. Por ejemplo, 30 de julio.
Clase month_day_last	Último día del mes.
Clase month_weekday	Día de la semana (en número) de un mes específico.
Clase month_weekday_last	Día de la semana (en número) de un mes específico.
Clase time_point	A un momento dado.
Clase weekday	Día de la semana.
Clase weekday_last	Último día laborable de un mes.
Clase weekday_indexed	Combina un día de la semana con un índice que representa el día de la semana del mes.
Clase year	Fecha en el calendario gregoriano.
Clase year_month	Año y mes. No se especifica el día.
Clase year_month_day	Año, mes y día.
Clase year_month_day_last	Último día de un mes y año específicos.
Clase year_month_weekday	Año, mes y día de la semana (en número) específicos del mes.
Clase year_month_weekday_last	Año, mes y último día de la semana específicos del mes.

Relojes

Nombre	Descripción
Clase file_clock	Alias del reloj usado para std::filesystem::file_time_type, que se usa para expresar marcas de tiempo de archivo.
Clase gps_clock	Reloj que mantiene el tiempo de GPS. Mide la hora a partir del primer domingo de enero de 1980 a las 00:00:00 UTC.
Estructura high_resolution_clock	Reloj con un período de graduación nanosegundos.
Estructura local_t	Pseudoproceso que se usa como argumento para la plantilla time_point para indicar que time_point representa la hora local.
Estructura steady_clock	Reloj steady. Este reloj se prefiere para medir los intervalos de tiempo.
Estructura system_clock	Reloj basado en el reloj en tiempo real del sistema.
Clase tai_clock	Mide la hora atómica internacional (TAI) a partir del jueves 1 de enero de 1958 a las 00:00:00. Este reloj no tiene en cuenta los segundos intercalares.
Clase utc_clock	Este reloj mide la hora desde las 00:00:00 UTC del jueves 1 de enero de 1970. Este reloj tiene en cuenta los segundos intercalares, y es el tiempo estándar utilizado en todo el mundo.

Zonas horarias

Nombre	Descripción
choose	Enumeración que especifica cómo resolver la conversión ambigua de local_time a sys_time.
local_info	Proporciona una interfaz de bajo nivel a información de zona horaria sobre el resultado de convertir un local_time en un sys_time.
sys_info	Proporciona una interfaz de bajo nivel a información de zona horaria sobre el resultado de convertir un sys_time en un local_time.
Clase time_zone	Todas las transiciones de zonas horarias para un área geográfica específica.
Clase time_zone_link	Nombre alternativo de time_zone.
Estructura tzdb	Representa una copia de la base de datos de zona horaria.
Clase tzdb_list	Lista única de bases de datos de zonas horarias.
Clase zoned_time	Emparejamiento de time_zone y time_point con una precisión especificada.
Estructura zoned_traits	Se usa para asociar una zona horaria predeterminada diferente a zoned_time, y, opcionalmente, asignar un nombre personalizado a esa zona horaria predeterminada.

Excepciones

Nombre	Descripción
ambiguous_local_time	Error producido cuando local_time se convierte en sys_time y el resultado es ambiguo.
nonexistent_local_time	Error producido cuando local_time se convierte en sys_time y el resultado es una hora que no existe.

Funciones

Nombre	Descripción
ceil(duration)	Devuelve el ceil de un objeto duration como un tipo especificado.
ceil(time_point)	Devuelve el ceil de un objeto time_point como un tipo especificado.
clock_cast	Convierte time_point de un reloj en un equivalente time_point para otro reloj.
duration_cast	Convierte un objeto duration a un tipo especificado.
floor(duration)	Devuelve el floor de un objeto duration como un tipo especificado.
floor(time_point)	Devuelve el floor de un objeto time_point como un tipo especificado.
from_stream()	Analice el flujo de entrada en uno de los tipos de intervalo o hora std::chrono, como day, month, weekday y year con el formato especificado.
get_leap_second_info	Obtiene una estructura leap_second_info .
is_am	Si un objeto hours es AM.
is_pm	Si un objeto hours es PM.
locate_zone	Obtiene la zona horaria especificada.
make12	Devuelve un hours en formato de 12 horas.
make24	Devuelve un hours en formato de 12 horas.
round(duration)	Devuelve un objeto duration redondeado como un tipo especificado.
round(time_point)	Devuelve un objeto time_point redondeado como un tipo especificado.
time_point_cast	Convierte un objeto time_point a un tipo especificado.

Zona horaria relacionada

Nombre	Descripción
current_zone	Obtiene la zona horaria actual.
get_tzdb	Obtiene la primera entrada de la base de datos de la zona horaria.
get_tzdb_list	Obtiene una lista de entradas de la base de datos de la zona horaria.
reload_tzdb	Obtiene una entrada actualizada de la base de datos de la zona horaria.
remote_version	Comprueba si hay una entrada actualizada de la base de datos de la zona horaria.

Operadores

Nombre	Descripción
operator-	Resta o niega varios objetos <chrono>.
operator!=	Operador de desigualdad que se utiliza con varios objetos <chrono>.
operator modulo	Operador para operaciones de módulo en objetos duration.
operator*	Operador de multiplicación para objetos duration.
operator/	Operador de división para objetos duration.
operator/	Proporciona sintaxis para crear fechas de calendario.
operator+	Agregue a varios objetos <chrono>.
operator<	Determina si varios objetos <chrono> son menores que otros.
operator<=	Determina si varios objetos <chrono> son menores o iguales que otros.
operator==	Determina si varios objetos <chrono> son iguales entre sí.
operator>	Determina si varios objetos <chrono> son mayores que otros.
operator>=	Determina si varios objetos <chrono> son mayores que otros o iguales entre sí.

Typedefs

Para obtener más información sobre los tipos de relación que se usan en los siguientes typedefs, vea <ratio>.

Tipos de conveniencia duration

Nombre	Descripción
typedef duration<long long, nano> nanoseconds;	Sinónimo de un tipo duration que tiene un período de ciclo de un milmillonésimo (1/1 000 000 000) de segundo.
typedef duration<long long, micro> microseconds;	Sinónimo de un tipo duration que tiene un período de ciclo de un millonésimo (1/1 000 000) de segundo.
typedef duration<long long, milli> milliseconds;	Sinónimo de un tipo duration que tiene un período de ciclo de una milésima (1/1000) de segundo.
typedef duration<long long> seconds;	Sinónimo de un tipo duration que tiene un período de ciclo de 1 segundo.
typedef duration<int, ratio<60>> minutes;	Sinónimo de un tipo duration que tiene un período de ciclo de 1 minuto.
typedef duration<int, ratio<3600>> hours;	Sinónimo de un tipo duration que tiene un período de ciclo de 1 hora.

Tipos de conveniencia time_point

Nombre	Descripción
file_time	Sinónimo de time_point<file_clock, Duration>. Representa un time_point para un file_clock. Especifique el Duration, por ejemplo, file_time<seconds> ft;.
gps_seconds	Un sinónimo de gps_time<seconds>; Un recuento de segundos, representado por un time_point que está asociado con un gps_clock.
gps_time	Sinónimo de time_point<gps_clock, Duration>. Representa un time_point para un gps_clock. Especifique el Duration, por ejemplo, gps_time<milliseconds> gps;.
local_days	Sinónimo de local_time<days>. Recuento de días, representado por un time_point que está asociado a cualquier zona horaria.
local_seconds	Sinónimo de local_time<seconds>.
local_time	Sinónimo de time_point<local_t, Duration>. Representa un time_point para una hora local que aún no está asociada a una zona horaria. Especifique el Duration, por ejemplo, local_time<seconds> lt;. Una local_time es una hora local en algún lugar. No es la hora local actual del reloj del equipo. Solo cuando se empareja un local_time con time_zone, se obtiene un punto en el tiempo que se puede convertir a la hora UTC o la hora en una zona horaria específica.
sys_days	Sinónimo de sys_time<days>. Recuento de días desde la época del system_clock, representado por un time_point que está asociado a system_clock.
sys_seconds	Sinónimo de sys_time<seconds>. Recuento de segundos no intercalares desde la época de system_clock (1 de enero de 1970 a las 00:00:00 UTC), representado por un time_point que está asociado a system_clock.
sys_time	Sinónimo de time_point<system_clock, Duration>. Especifique el Duration, por ejemplo, sys_time<seconds> st;. Representa un time_point devuelto de system_clock::now(). Representa la hora Unix, que se aproxima estrechamente a la hora UTC.
tai_seconds	Sinónimo de tai_time<seconds>. Recuento de segundos, representado por un time_point que está asociado a tai_clock.
tai_time	Sinónimo de time_point<tai_clock, Duration>. Proporcione el Duration, por ejemplo, tai_time<seconds> tt;. Representa un time_point para un tai_clock.
utc_seconds	Sinónimo de utc_time<seconds>;.
utc_time	Sinónimo de time_point<utc_clock, Duration>. Proporcione el Duration, por ejemplo, utc_time<seconds> ut;. Representa un time_point para un utc_clock.

Rasgos de tipos

Nombre	Descripción
clock_time_conversion	Rasgo que especifica cómo convertir time_point de un reloj a otro.
is_clock	Comprueba si un tipo es un reloj.
treat_as_floating_point	Comprueba si duration puede convertirse en otro duration que tenga un período de paso diferente.

Literales

(C++11) El encabezado <chrono> define los siguientes literales definidos por el usuario que puede usar para mayor comodidad, seguridad de tipos y mantenimiento del código. Estos literales se definen en el espacio de nombres alineado literals::chrono_literals y están en ámbito cuando std::chrono está en ámbito.

Declaración	Descripción
hours operator "" h(unsigned long long Val)	Especifica horas como un valor entero.
duration<double, ratio<3600>> operator "" h(long double Val)	Especifica horas como un valor de coma flotante.
minutes (operator "" min)(unsigned long long Val)	Especifica minutos como un valor entero.
duration<double, ratio<60>> (operator "" min)( long double Val)	Especifica minutos como un valor de coma flotante.
seconds operator "" s(unsigned long long Val)	Especifica minutos como un valor entero.
duration<double> operator "" s(long double Val)	Especifica segundos como un valor de coma flotante.
milliseconds operator "" ms(unsigned long long Val)	Especifica milisegundos como un valor entero.
duration<double, milli> operator "" ms(long double Val)	Especifica milisegundos como un valor de coma flotante.
microseconds operator "" us(unsigned long long Val)	Especifica microsegundos como un valor entero.
duration<double, micro> operator "" us(long double Val)	Especifica microsegundos como un valor de coma flotante.
nanoseconds operator "" ns(unsigned long long Val)	Especifica nanosegundos como un valor entero.
duration<double, nano> operator "" ns(long double Val)	Especifica nanosegundos como un valor de coma flotante.

En los siguientes ejemplos se muestra cómo usar los literales <chrono>:

constexpr auto day = 24h;
constexpr auto week = 24h* 7;
constexpr auto my_duration_unit = 108ms;

Consulte también

Referencia de archivos de encabezado