std::chrono::duration_cast

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

日期和時間庫

時間點 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 時長 duration (C++11) 時鐘 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) 日間時間 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

日曆 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 I/O parse (C++20)

時區 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風格日期和時間

 

std::chrono::duration

成員函式
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%=
非成員函式
operator+operator-operator*operator/operator% operator==operator!=operator<operator<=operator>operator>=operator<=> (until 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)
輔助類
common_type treat_as_floating_point      duration_values	formatter<std::chrono::duration> (C++20) hash<std::chrono::duration> (C++26)

 

定義於標頭檔案 <chrono>
template< class ToDuration, class Rep, class Period > constexpr ToDuration duration_cast( const std::chrono::duration<Rep, Period>& d );		(C++11 起)

將 std::chrono::duration 轉換為不同型別 ToDuration 的 duration。

僅當 ToDuration 是 std::chrono::duration 的特化時，此函式才參與過載決議。

令

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

結果為

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

引數

d

-

要轉換的 duration

返回值

d 轉換為型別 ToDuration 的 duration。

注意

不使用隱式轉換。如果編譯時已知一個或多個引數為 1，則儘可能避免乘法和除法。計算在可用的最寬型別中進行，並且只在完成後才透過 static_cast 轉換為結果型別。

整數 duration 之間（源週期可被目標週期精確整除，例如小時到分鐘）或浮點 duration 之間的轉換可以使用普通轉換或透過 std::chrono::duration 建構函式隱式進行，無需 duration_cast。

當浮點值為 NaN、無窮大或太大而無法由目標整數型別表示時，從浮點 duration 轉換為整數 duration 會導致未定義行為。否則，轉換為整數 duration 會像任何 static_cast 轉換為整數型別一樣進行截斷。

示例

此示例測量函式的執行時間。

執行此程式碼

#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";
}

可能的輸出

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

參閱

duration (C++11)	時間間隔 (類模板)
time_point_cast (C++11)	將一個時間點轉換為同一時鐘上的另一個時間點，但具有不同的時長 (函式模板)
floor(std::chrono::duration) (C++17)	將一個 duration 轉換為另一個，向下取整 (函式模板)
ceil(std::chrono::duration) (C++17)	將一個 duration 轉換為另一個，向上取整 (函式模板)
round(std::chrono::duration) (C++17)	將一個 duration 轉換為另一個，四捨五入到最接近的值，平局時取偶數 (函式模板)