std::chrono::duration

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

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

言語サポート 型サポート (基本型、RTTI、型特性) ライブラリの機能テストマクロ (C++20) 動的メモリ管理 プログラムユーティリティ エラー処理 コルーチンサポート (C++20) 可変長引数関数 launder (C++17) initializer_list (C++11) source_location (C++20) 三方比較 (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_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

汎用ユーティリティ 日付と時間 関数オブジェクト 書式化ライブラリ (C++20) bitset hash (C++11) integer_sequence (C++14) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than (C++20)(C++20)(C++20)(C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) forward (C++11) move (C++11) move_if_noexcept (C++11) as_const (C++17) 一般的な語彙の型 pair tuple (C++11) apply (C++17) make_from_tuple (C++17) optional (C++17) any (C++17) variant (C++17) 初等文字列変換 to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

日付と時間のユーティリティ

duration (C++11) time_point (C++11)	clock_time_conversion (C++20) clock_cast (C++20)
時刻
hh_mm_ss (C++20)	is_amis_pmmake12make24 (C++20)(C++20)(C++20)(C++20)
時計
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)
カレンダー
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)
タイムゾーン
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20)	time_zone (C++20) locate_zone (C++20) current_zone (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (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)

 

<tbody> </tbody>

ヘッダ <chrono> で定義
template< class Rep, class Period = std::ratio<1> > class duration;		(C++11以上)

クラステンプレート std::chrono::duration は時の間隔を表します。

これは刻み数と刻み幅から構成されます。 刻み数は Rep 型の値で、刻み幅はある刻みから次の刻みまでの秒数を表すコンパイル時有理数の定数です。

duration に格納されるデータは Rep 型の刻み数だけです。 Rep が浮動小数点の場合は、 duration は小数点以下の刻み数を表現できます。 Period は duration の型の一部に含まれ、異なる duration 間で変換するときにのみ使用されます。

メンバ型

メンバ型	定義
rep	Rep、刻み数を表す算術型
period	Period (C++17未満)typename Period::type (C++17以上)、刻み幅を表す std::ratio (すなわち刻み1つあたりの秒数)

メンバ関数

コンストラクタ	新しい時間を構築します (パブリックメンバ関数)
operator=	内容を代入します (パブリックメンバ関数)
count	刻み数を返します (パブリックメンバ関数)
zero [静的]	長さゼロの時間を返します (パブリック静的メンバ関数)
min [静的]	時間の最小値を返します (パブリック静的メンバ関数)
max [静的]	時間の最大値を返します (パブリック静的メンバ関数)
operator+operator-	単項 + および単項 - を実装します (パブリックメンバ関数)
operator++operator++(int)operator--operator--(int)	刻み数をインクリメントまたはデクリメントします (パブリックメンバ関数)
operator+=operator-=operator*=operator/=operator%=	2つの時間の間の複合代入を実装します (パブリックメンバ関数)

非メンバ関数

operator+operator-operator*operator/operator%	引数として時間を取る算術演算を実装します (関数テンプレート)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20で削除)(C++20)	2つの時間を比較します (関数テンプレート)
duration_cast	時間を異なる刻み幅を持つ別の時間に変換します (関数テンプレート)
floor(std::chrono::duration) (C++17)	時間を別の時間に切り捨て変換します (関数テンプレート)
ceil(std::chrono::duration) (C++17)	時間を別の時間に切り上げ変換します (関数テンプレート)
round(std::chrono::duration) (C++17)	時間を別の時間の最も近い値に丸めて変換します (関数テンプレート)
abs(std::chrono::duration) (C++17)	時間の絶対値を取得します (関数テンプレート)
operator<< (C++20)	duration に対してストリーム出力を行います (関数テンプレート)
from_stream (C++20)	指定された書式に従って duration をストリームからパースします (関数テンプレート)

ヘルパー型

型	定義
std::chrono::nanoseconds	duration</*signed integer type of at least 64 bits*/, std::nano>
std::chrono::microseconds	duration</*signed integer type of at least 55 bits*/, std::micro>
std::chrono::milliseconds	duration</*signed integer type of at least 45 bits*/, std::milli>
std::chrono::seconds	duration</*signed integer type of at least 35 bits*/>
std::chrono::minutes	duration</*signed integer type of at least 29 bits*/, std::ratio<60>>
std::chrono::hours	duration</*signed integer type of at least 23 bits*/, std::ratio<3600>>
std::chrono::days (C++20以上)	duration</*signed integer type of at least 25 bits*/, std::ratio<86400>>
std::chrono::weeks (C++20以上)	duration</*signed integer type of at least 22 bits*/, std::ratio<604800>>
std::chrono::months (C++20以上)	duration</*signed integer type of at least 20 bits*/, std::ratio<2629746>>
std::chrono::years (C++20以上)	duration</*signed integer type of at least 17 bits*/, std::ratio<31556952>>

ノート: 定義済みの時間型 nanoseconds, microseconds, milliseconds, seconds, minutes, hours は、いずれも少なくとも±292年の範囲をカバーします。

定義済みの時間型 days, weeks, months, years は、いずれも少なくとも±40000年の範囲をカバーします。 years は 365.2425 days (グレゴリオ暦の1年の平均的な長さ) に等しく、 months は 30.436875 days (years のちょうど 1/12) に等しいと定義されます。

(C++20以上)

ヘルパークラス

std::common_type<std::chrono::duration>	std::common_type 特性の特殊化 (クラステンプレートの特殊化)
treat_as_floating_point	時間が異なる刻み幅を持つ時間に変換可能であることを表します (クラステンプレート)
duration_values	ゼロ、最小、最大の刻み数を持つ指定された型の値を構築します (クラステンプレート)
std::formatter<std::chrono::duration> (C++20)	提供された書式に従って duration を書式化する std::formatter の特殊化 (クラステンプレートの特殊化)

リテラル

名前空間 std::literals::chrono_literals で定義
operator""h (C++14)	時間を表す std::chrono::duration リテラル (関数)
operator""min (C++14)	分を表す std::chrono::duration リテラル (関数)
operator""s (C++14)	秒を表す std::chrono::duration リテラル (関数)
operator""ms (C++14)	ミリ秒を表す std::chrono::duration リテラル (関数)
operator""us (C++14)	マイクロ秒を表す std::chrono::duration リテラル (関数)
operator""ns (C++14)	ナノ秒を表す std::chrono::duration リテラル (関数)

ノート: リテラル接尾辞 d, y は days, years ではなく day, year をそれぞれ参照します。

(C++20以上)

例

この例は、どのようにカスタム時間型を定義し、その型の間で変換を行うかを示します

Run this code

#include <iostream>
#include <chrono>

constexpr auto year = 31556952ll; // グレゴリオ暦の1年の平均的な秒数

int main()
{
    using shakes = std::chrono::duration<int, std::ratio<1, 100000000>>;
    using jiffies = std::chrono::duration<int, std::centi>;
    using microfortnights = std::chrono::duration<float, std::ratio<14*24*60*60, 1000000>>;
    using nanocenturies = std::chrono::duration<float, std::ratio<100*year, 1000000000>>;

    std::chrono::seconds sec(1);
   
    std::cout << "1 second is:\n";

    // 精度喪失を伴わない整数型の単位変換 (キャスト不要)。
    std::cout << std::chrono::microseconds(sec).count() << " microseconds\n"
              << shakes(sec).count() << " shakes\n"
              << jiffies(sec).count() << " jiffies\n";

    // 精度喪失を伴う整数型の単位変換 (キャストが必要)。
    std::cout << std::chrono::duration_cast<std::chrono::minutes>(sec).count()
              << " minutes\n";

    // 浮動小数点型の単位変換 (キャスト不要)。
    std::cout << microfortnights(sec).count() << " microfortnights\n"
              << nanocenturies(sec).count() << " nanocenturies\n";
}

出力:

1 second is:
1000000 microseconds
100000000 shakes
100 jiffies
0 minutes
0.82672 microfortnights
0.316887 nanocenturies