std::chrono:: duration

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

これは Rep 型のティックカウントとティック周期で構成され、ティック周期はコンパイル時有理数 fraction であり、1ティックから次のティックまでの時間を秒単位で表します。

duration に格納される唯一のデータは、型 Rep のティックカウントです。 Rep が浮動小数点型の場合、 duration はティックの小数部分を表現できます。 Period はdurationの型の一部として含まれ、異なるduration間の変換時にのみ使用されます。

メンバー型

メンバー関数

非メンバー関数

ヘルパー型

以下の表で使用される型 /* intXX */ は、少なくともXXビットの符号付き整数型を意味します。

注意: 事前定義された期間型はそれぞれ、 hours まで、少なくとも±292年の範囲をカバーします。

ヘルパークラス

ヘルパー特殊化

この std::enable_nonlocking_formatter_optimization の特殊化は、テンプレートパラメータ Rep がそれを有効にする場合に、 chrono::duration オブジェクトを出力するための std::print および std::println の効率的な実装を可能にします。

リテラル

注記

期間オブジェクト d が保持する実際の時間間隔（秒単位）は、おおよそ d. count ( ) * D :: period :: num / D :: period :: den に等しくなります。ここで D は chrono::duration<> 型であり、 d はその型のオブジェクトです。

例

#include <chrono>
#include <iostream>
using namespace std::chrono_literals;
template<typename T1, typename T2>
using mul = std::ratio_multiply<T1, T2>;
int main()
{
    using microfortnights = std::chrono::duration<float,
        mul<mul<std::ratio<2>, std::chrono::weeks::period>, std::micro>>;
    using nanocenturies = std::chrono::duration<float,
        mul<mul<std::hecto, std::chrono::years::period>, std::nano>>;
    using fps_24 = std::chrono::duration<double, std::ratio<1, 24>>;
    std::cout << "1 second is:\n";
    // integer scale conversion with no precision loss: no cast
    std::cout << std::chrono::milliseconds(1s).count() << " milliseconds\n"
              << std::chrono::microseconds(1s).count() << " microseconds\n"
              << std::chrono::nanoseconds(1s).count() << " nanoseconds\n";
    // integer scale conversion with precision loss: requires a cast
    std::cout << std::chrono::duration_cast<std::chrono::minutes>(1s).count()
              << " minutes\n";
    // alternative to duration_cast:
    std::cout << 1s / 1min << " minutes\n";
    // floating-point scale conversion: no cast
    std::cout << microfortnights(1s).count() << " microfortnights\n"
              << nanocenturies(1s).count() << " nanocenturies\n"
              << fps_24(1s).count() << " frames at 24fps\n";
}

1 second is:
1000 milliseconds
1000000 microseconds
1000000000 nanoseconds
0 minutes
0 minutes
0.82672 microfortnights
0.316887 nanocenturies
24 frames at 24fps