duration.md

duration

• chrono[meta header]
• std::chrono[meta namespace]
• class template[meta id-type]
• cpp11[meta cpp]

namespace std {
namespace chrono {
  template <class Rep, class Period = ratio<1>>
  class duration;
}}

• ratio[link /reference/ratio.md]

概要

durationは、2つの時間の間隔を表現するための型である。

durationのテンプレートパラメータであるratioの値によって、時間のためのあらゆる単位(ナノ秒、ミリ秒、秒, etc...)を表現することができる。

標準では、以下の別名が提供される：

型の別名	説明	対応バージョン
nanoseconds	ナノ秒	C++11
microseconds	マイクロ秒	C++11
milliseconds	ミリ秒	C++11
seconds	秒	C++11
minutes	分	C++11
hours	時	C++11

メンバ関数

構築／コピー／破棄

名前	説明	対応バージョン
(constructor)	コンストラクタ	C++11
~duration() = default;	デストラクタ	C++11
operator=(const duration&) = default;	代入演算子	C++11

観測

名前	説明	対応バージョン
count	値を取得する	C++11

算術演算

名前	説明	対応バージョン
operator+	正のdurationを生成する	C++11
operator-	負のdurationを生成する	C++11
operator++	値をインクリメントする	C++11
operator--	値をデクリメントする	C++11
operator+=	+の複合代入	C++11
operator-=	-の複合代入	C++11
operator*=	*の複合代入	C++11
operator/=	/の複合代入	C++11
operator%=	%の複合代入	C++11

静的メンバ関数

特別な値

名前	説明	対応バージョン
zero	初期値を取得	C++11
min	最小値を取得	C++11
max	最大値を取得	C++11

メンバ型

名前	説明	対応バージョン
rep	値の数値型 Rep	C++11
period	値の周期を表す型 Period	C++11

非メンバ関数

丸め演算

名前	説明	対応バージョン
duration_cast	ゼロ方向への丸め	C++11
floor	負の無限大方向への丸め	C++17
ceil	正の無限大方向への丸め	C++17
round	偶数方向への丸め	C++17

その他数学関数

名前	説明	対応バージョン
abs	絶対値を求める	C++17

算術演算

名前	説明	対応バージョン
operator+	加算	C++11
operator-	減算	C++11
operator*	乗算	C++11
operator/	除算	C++11
operator%	剰余算	C++11

比較演算

名前	説明	対応バージョン
operator==	等値判定を行う	C++11
operator!=	非等値判定を行う	C++11
operator<	左辺が右辺より小さいか判定を行う	C++11
operator<=	左辺が右辺以下かの判定を行う	C++11
operator>	左辺が右辺より大きいか判定を行う	C++11
operator>=	左辺が右辺以上かの判定を行う	C++11

入出力

名前	説明	対応バージョン
operator<<	ストリームへの出力	C++20
to_stream	フォーマットを指定してストリームへ出力	C++20
from_stream	フォーマットを指定してストリームから入力	C++20

リテラル

名前	説明	対応バージョン
ns	ナノ秒リテラル	C++14
us	マイクロ秒リテラル	C++14
ms	ミリ秒リテラル	C++14
s	秒リテラル	C++14
min	分リテラル	C++14
h	時リテラル	C++14
d	日リテラル	C++20
y	年リテラル	C++20

common_type特殊化

名前	説明	対応バージョン
common_type	異なるduration間の共通の型を求める	C++11

例

#include <iostream>
#include <chrono>
#include <ctime>

using std::chrono::system_clock;
using std::chrono::seconds;

void print(const system_clock::time_point& p)
{
  std::time_t t = system_clock::to_time_t(p);
  char buf[26];  // 最低26バイトが必要
# ifdef _MSC_VER
  // Visual Studioではctime_s()が推奨されている。
  ctime_s(buf, 26, &t);
# else
  // ctime()のリエントラント版
  ctime_r(&t, buf);
# endif
  // 出力された文字列には改行が含まれていることに注意
  std::cout << buf;
}

int main()
{
  // 現在日時を取得
  system_clock::time_point now = system_clock::now();

  // 3秒後の日時を取得
  system_clock::time_point p = now + seconds(3);

  print(now);
  print(p);
}

• system_clock[link system_clock.md]
• to_time_t[link system_clock/to_time_t.md]
• now()[link system_clock/now.md]
• seconds[link seconds.md]

出力例

Tue Oct 16 16:25:08 2012
Tue Oct 16 16:25:11 2012

バージョン

言語

• C++11

処理系

• GCC, C++11 mode: 4.7.0
• Visual C++: 2012, 2013, 2015

参照