std::chrono::duration_cast

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

日付と時刻ライブラリ

時間点 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<=> (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つ以上のパラメータが 1 であることがわかっている場合、可能な限り回避されます。計算は、利用可能な最も広い型で行われ、結果の型への static_cast と同様に、完了時にのみ変換されます。

整数 duration 間での、ソース期間がターゲット期間で正確に割り切れる場合（例：時間から分へ）のキャスト、または浮動小数点数 duration 間のキャストは、通常のキャストまたは std::chrono::duration のコンストラクタを介した暗黙の変換で実行できます。この場合、duration_cast は必要ありません。

浮動小数点数 duration から整数 duration へのキャストは、浮動小数点数の値が NaN、無限大、またはターゲットの整数型で表現できないほど大きい場合、未定義の動作の対象となります。それ以外の場合、整数 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)	期間を別の期間に変換し、切り捨てる (関数テンプレート)
ceil(std::chrono::duration) (C++17)	期間を別の期間に変換し、切り上げる (関数テンプレート)
round(std::chrono::duration) (C++17)	期間を別の期間に変換し、最も近い値に丸め、等距離の場合は偶数に丸める (関数テンプレート)