std::chrono::duration

 

C++

言語

ヘッダ

コンセプト

言語サポートライブラリ

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

アルゴリズムライブラリ

イテレータライブラリ

数値演算ライブラリ

入出力ライブラリ

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

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

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

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

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

技術仕様書

 

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

型サポート (基本型、RTTI、型特性)
動的メモリ管理
エラー処理
プログラムユーティリティ
可変長引数関数
日付と時間
関数オブジェクト
initializer_list (C++11)
bitset
hash (C++11)
integer_sequence (C++14)
関係演算子 (廃止予定)
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
比較 (C++20)
strong_order weak_order partial_order strong_equal weak_equal	strong_ordering weak_ordering partial_ordering strong_equality weak_equality	is_eqis_neqis_ltis_lteqis_gtis_gteq
common_comparison_category
一般的な語彙の型
pair tuple (C++11) apply (C++17) make_from_tuple (C++17)	optional (C++17) any (C++17) variant (C++17)
交換、転送、ムーブ
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
基本的な文字列変換
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
型操作
declval (C++11)
as_const (C++17)

 

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

duration (C++11) time_point (C++11) time_of_day (C++20)	clock_time_conversion (C++20) clock_cast (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) link (C++20) leap (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) to_stream (C++20)	common_type 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)
ヘルパークラス
treat_as_floating_point duration_values

 

ヘッダ <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 [static]	長さゼロの時間を返します (パブリック静的メンバ関数)
min [static]	時間の最小値を返します (パブリック静的メンバ関数)
max [static]	時間の最大値を返します (パブリック静的メンバ関数)
operator+operator-	単項 + および単項 - を実装します (パブリックメンバ関数)
operator++operator++(int)operator--operator--(int)	刻み数をインクリメントまたはデクリメントします (パブリックメンバ関数)
operator+=operator-=operator*=operator/=operator%=	2つの時間の間の複合代入を実装します (パブリックメンバ関数)

非メンバ関数

std::common_type<std::chrono::duration>	std::common_type 特性の特殊化 (クラステンプレートの特殊化)
operator+operator-operator*operator/operator%	引数として時間を取る算術演算を実装します (関数テンプレート)
operator==operator!=operator<operator<=operator>operator>=	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 に対してストリーム出力を行います (関数テンプレート)
to_stream (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およびそれ以降)

ヘルパークラス

treat_as_floating_point	時間が異なる刻み幅を持つ時間に変換可能であることを表します (クラステンプレート)
duration_values	ゼロ、最小、最大の刻み数を持つ指定された型の値を構築します (クラステンプレート)

リテラル

名前空間 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; // seconds in average Gregorian year
 
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";
 
    // integer scale conversion with no precision loss: no cast
    std::cout << std::chrono::microseconds(sec).count() << " microseconds\n"
              << shakes(sec).count() << " shakes\n"
              << jiffies(sec).count() << " jiffies\n";
 
    // integer scale conversion with precision loss: requires a cast
    std::cout << std::chrono::duration_cast<std::chrono::minutes>(sec).count()
              << " minutes\n";
 
    // floating-point scale conversion: no cast
    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