std::chrono::duration_cast

 

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) Macros de prueba de característica de la biblioteca (C++20) Servicios de programa Funciones variádicas initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Apoyo de corrutinas (C++20) Apoyo de contratos (C++26) Comparación de tres vías (C++20) 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::duration

Funciones miembro
duration::duration duration::operator= duration::count duration::zero duration::min duration::max duration::operator+duration::operator-	duration::operator++duration::operator-- duration::operator+=duration::operator-=duration::operator*=duration::operator/=duration::operator%=
Funciones no miembro
operator+operator-operator*operator/operator% operator==operator!=operator<operator<=operator>operator>=operator<=> (hasta C++20)(C++20) operator<< (C++20)	duration_cast floor (C++17) ceil (C++17) round (C++17) abs (C++17) operator""h (C++14) operator""min (C++14) operator""s (C++14) operator""ms (C++14) operator""us (C++14) operator""ns (C++14) from_stream (C++20)
Clases auxiliares
common_type treat_as_floating_point	duration_values formatter<std::chrono::duration> (C++20)

 

Definido en el archivo de encabezado <chrono>
template <class ToDuration, class Rep, class Period> constexpr ToDuration duration_cast(const std::chrono::duration<Rep,Period>& d);		(desde C++11)

Convierte un objeto de tipo std::chrono::duration en una duración de diferente tipo ToDuration.

La función no participa en la resolución de sobrecarga a menos que ToDuration sea una especialización de std::chrono::duration.

No se utilizan conversiones implícitas. Las multiplicaciones y divisiones se evitan siempre que sea posible, si se sabe en tiempo de compilación que uno o más parámetros son 1. Los cálculos se realizan en el tipo más ancho disponible y se convierten, como si fuera static_cast, al tipo de resultado solo cuando finaliza.

Parámetros

d

-

La duración a convertir.

Valor de retorno

d convertida a una duración de tipo ToDuration.

Notas

La conversión entre duraciones enteras donde el período de origen es exactamente divisible por el período de destino (por ejemplo, horas a minutos) o entre duraciones de punto flotante se puede realizar con conversiones ordinarias o implícitamente a través de constructores de std::chrono::duration, no se necesita duration_cast.

La conversión de una duración de punto flotante a una duración de tipo entero está sujeta a comportamiento no definido cuando el valor de punto flotante es NaN, infinito o demasiado grande para ser representable por el tipo entero del destino. De lo contrario, la conversión a una duración de tipo entero está sujeta a truncamiento como con cualquier static_cast a un tipo de tipo entero.

Ejemplo

Este ejemplo mide el tiempo de ejecución de una función.

Ejecuta este código

#include <iostream>
#include <chrono>
#include <ratio>
#include <thread>
 
void f()
{
    std::this_thread::sleep_for(std::chrono::seconds(1));
}
 
int main()
{
    auto t1 = std::chrono::high_resolution_clock::now();
    f();
    auto t2 = std::chrono::high_resolution_clock::now();

    // duración de punto flotante: no se necesita duration_cast
    std::chrono::duration<double, std::milli> fp_ms = t2 - t1;

    // duración de tipo entero: requiere duration_cast
    auto int_ms = std::chrono::duration_cast<std::chrono::milliseconds>(t2 - t1);

    // convertir la duración de tipo entero a la duración de tipo entero
    // de la unidad de tiempo divisible más corta: no se necesita duration_cast
    std::chrono::duration<long, std::micro> int_usec = int_ms;
 
    std::cout << "f() tomó " << fp_ms.count() << " ms, "
              << "o " << int_ms.count() << " milisegundos completos "
              << "(que es " << int_usec.count() << " microsegundos completos)" << std::endl;
}

Posible salida:

f() tomó 1000.23 ms, o 1000 milisegundos completos (que es 1000000 microsegundos completos)

Véase también

duration (C++11)	Un intervalo de tiempo. (plantilla de clase)
time_point_cast	Convierte un punto de tiempo a otro punto de tiempo en el mismo reloj, con una duración diferente. (plantilla de función)
floor(std::chrono::duration) (C++17)	Convierte una duración a otra, redondeando hacia abajo. (plantilla de función)
ceil(std::chrono::duration) (C++17)	Convierte una duración a otra, redondeando hacia arriba. (plantilla de función)
round(std::chrono::duration) (C++17)	Convierte una duración a otra, redondeando al más cercano, se empata con par. (plantilla de función)