std::chrono::duration_cast

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Datums- und Zeitbibliothek

Zeitpunkt time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) Dauer duration (C++11) Uhren system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) Tageszeit is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

Kalender 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) chrono E/A parse (C++20)

Zeitzone 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) C-Stil Datums- und Zeitfunktionen

 

std::chrono::duration

Memberfunktionen
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%=
Nicht-Member-Funktionen
operator+operator-operator*operator/operator% operator==operator!=operator<operator<=operator>operator>=operator<=> (bis 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)
Hilfsklassen
common_type treat_as_floating_point      duration_values	formatter<std::chrono::duration> (C++20) hash<std::chrono::duration> (C++26)

 

Definiert in Header <chrono>
template< class ToDuration, class Rep, class Period > constexpr ToDuration duration_cast( const std::chrono::duration<Rep, Period>& d );		(seit C++11)

Konvertiert eine std::chrono::duration in eine Dauer eines anderen Typs ToDuration.

Die Funktion nimmt nur an der Überladungsauflösung teil, wenn ToDuration eine Spezialisierung von std::chrono::duration ist.

Seien

• ToRep sei typename ToDuration::rep,
• ToPeriod sei typename ToDuration::period,
• CF sei std::ratio_divide<Period, ToPeriod>,
• CR sei std::common_type<Rep, ToRep, std::intmax_t>::type,
• cr_count sei static_cast<CR>(d.count()),
• cr_num sei static_cast<CR>(CF::num), und
• cr_den sei static_cast<CR>(CF::den),

ist das Ergebnis

		CF::num
		1	nicht 1
CF::den	1	ToDuration(static_cast<ToRep>                (d.count()))	ToDuration(static_cast<ToRep>                (cr_count * cr_num))
	nicht 1	ToDuration(static_cast<ToRep>                (cr_count / cr_den))	ToDuration(static_cast<ToRep>                (cr_count * cr_num / cr_den))

Parameter

d

-

zu konvertierende Dauer

Rückgabewert

d konvertiert in eine Dauer vom Typ ToDuration.

Anmerkungen

Es werden keine impliziten Konvertierungen verwendet. Multiplikationen und Divisionen werden vermieden, wo immer möglich, wenn zur Kompilierzeit bekannt ist, dass einer oder mehrere Parameter 1 sind. Berechnungen erfolgen im breitesten verfügbaren Typ und werden, als ob sie mittels static_cast erfolgten, erst nach Abschluss in den Ergebnistyp konvertiert.

Konvertierungen zwischen Ganzzahldauern, bei denen die Quellperiode exakt durch die Zielperiode teilbar ist (z. B. Stunden in Minuten) oder zwischen Fließkommadauern, können mit gewöhnlichen Konvertierungen oder implizit über std::chrono::duration Konstruktoren erfolgen, ohne dass duration_cast benötigt wird.

Die Konvertierung von einer Fließkommadauer in eine Ganzzahldauer ist undefiniertem Verhalten unterworfen, wenn der Fließkommawert NaN, unendlich oder zu groß ist, um ihn durch den Ganzzahltyp des Ziels darstellen zu können. Ansonsten unterliegt die Konvertierung in eine Ganzzahldauer der Abschneidung, wie bei jeder static_cast in einen Ganzzahltyp.

Beispiel

Dieses Beispiel misst die Ausführungszeit einer Funktion.

Führen Sie diesen Code aus

#include <chrono>
#include <iostream>
#include <ratio>
#include <thread>
 
void f()
{
    std::this_thread::sleep_for(std::chrono::seconds(1));
}
 
int main()
{
    const auto t1 = std::chrono::high_resolution_clock::now();
    f();
    const auto t2 = std::chrono::high_resolution_clock::now();
 
    // floating-point duration: no duration_cast needed
    const std::chrono::duration<double, std::milli> fp_ms = t2 - t1;
 
    // integral duration: requires duration_cast
    const auto int_ms = std::chrono::duration_cast<std::chrono::milliseconds>(t2 - t1);
 
    // converting integral duration to integral duration of
    // shorter divisible time unit: no duration_cast needed
    const std::chrono::duration<long, std::micro> int_usec = int_ms;
 
    std::cout << "f() took " << fp_ms << ", or "
              << int_ms << " (whole milliseconds), or "
              << int_usec << " (whole microseconds)\n";
}

Mögliche Ausgabe

f() took 1000.14ms, or 1000ms (whole milliseconds), or 1000000us (whole microseconds)

Siehe auch

duration (C++11)	Ein Zeitintervall (Klassen-Template)
time_point_cast (C++11)	konvertiert einen Zeitpunkt in einen anderen auf derselben Uhr mit einer anderen Dauer (Funktionstemplate)
floor(std::chrono::duration) (C++17)	konvertiert eine Dauer in eine andere und rundet ab (Funktionstemplate)
ceil(std::chrono::duration) (C++17)	konvertiert eine Dauer in eine andere und rundet auf (Funktionstemplate)
round(std::chrono::duration) (C++17)	konvertiert eine Dauer in eine andere, rundet auf die nächste, bei Gleichstand zu geraden Zahlen (Funktionstemplate)