標準ライブラリヘッダ <chrono>

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

数値演算ライブラリ

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

入出力ライブラリ

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

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

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

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

技術仕様書

 

標準ライブラリヘッダ

言語サポート
<cstddef> <cstdlib> <version> <limits> <climits>	<cfloat> <cstdint> <new> <typeinfo>	<source_location> <exception> <initializer_list> <compare>	<coroutine> <csignal> <csetjmp> <cstdarg>
コンセプト
<concepts>
診断
<stdexcept>	<cassert>	<cerrno>	<system_error>
汎用ユーティリティ
<utility> <memory> <memory_resource> <scoped_allocator>	<bitset> <tuple> <optional> <any>	<variant> <type_traits> <ratio> <chrono>	<typeindex> <functional> <ctime>
文字列
<string> <string_view> <cstring>	<charconv> <format>	<cctype> <cwctype>	<cwchar> <cuchar>
ローカライゼーション
<locale>	<codecvt>	<clocale>
コンテナ
<span> <array> <vector>	<deque> <forward_list> <list>	<map> <set> <queue>	<unordered_map> <unordered_set> <stack>
イテレータ
<iterator>
範囲
<ranges>
アルゴリズム
<algorithm>	<execution>
数値演算
<complex> <random>	<valarray> <numeric>	<bit> <numbers>	<cfenv> <cmath>
入出力
<iosfwd> <ios> <iomanip> <streambuf>	<istream> <ostream> <iostream>	<sstream> <spanstream> <fstream> <syncstream>	<cstdio> <cinttypes> <strstream>
正規表現
<regex>
ファイルシステムサポート
<filesystem>
スレッドサポート
<thread> <atomic> <mutex>	<shared_mutex> <condition_variable> <future>	<stop_token> <semaphore>	<latch> <barrier>
C互換
<ciso646> <cstdalign>	<cstdbool> <ccomplex>	<ctgmath> <stdatomic.h>

 

このヘッダは日付と時間ライブラリの一部です。

クラス

名前空間 std::chrono で定義
duration (C++11)	時の間隔 (クラステンプレート)
system_clock (C++11)	システム全体のリアルタイムクロックをベースとする壁時計 (クラス)
steady_clock (C++11)	調整されることの決してない単調な時計 (クラス)
high_resolution_clock (C++11)	利用可能な最も短い刻み幅を持つ時計 (クラス)
time_point (C++11)	時のある一点 (クラステンプレート)
treat_as_floating_point	時間が異なる刻み幅を持つ時間に変換可能であることを表します (クラステンプレート)
duration_values	ゼロ、最小、最大の刻み数を持つ指定された型の値を構築します (クラステンプレート)
time_zone (C++20)	タイムゾーンを表します (クラス)
nonexistent_local_time (C++20)	ローカルタイムが存在しないことを報告するために投げられる例外 (クラス)
ambiguous_local_time (C++20)	ローカルタイムが曖昧であることを報告するために投げられる例外 (クラス)
便利な typedef
名前空間 std::chrono で定義
std::chrono::nanoseconds	std::nano の刻み幅を持つ時間型
std::chrono::microseconds	std::micro の刻み幅を持つ時間型
std::chrono::milliseconds	std::milli の刻み幅を持つ時間型
std::chrono::seconds	std::ratio<1> の刻み幅を持つ時間型
std::chrono::minutes	std::ratio<60> の刻み幅を持つ時間型
std::chrono::hours	std::ratio<3600> の刻み幅を持つ時間型
std::chrono::days	std::ratio<86400> の刻み幅を持つ時間型
std::chrono::weeks	std::ratio<604800> の刻み幅を持つ時間型
std::chrono::months	std::ratio<2629746> の刻み幅を持つ時間型
std::chrono::years	std::ratio<31556952> の刻み幅を持つ時間型
特殊化
名前空間 std で定義
std::common_type<std::chrono::duration>	std::common_type 特性の特殊化 (クラステンプレートの特殊化)
std::common_type<std::chrono::time_point>	std::common_type 特性の特殊化 (クラステンプレートの特殊化)

関数

時間
名前空間 std::chrono で定義
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)	時間の絶対値を取得します (関数テンプレート)
時点
名前空間 std::chrono で定義
operator+operator-	time point に対する加算および減算を行います (関数テンプレート)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20で削除)(C++20)	2つの time point を比較します (関数テンプレート)
time_point_cast	time point を同じ時計の異なる時間単位の time point に変換します (関数テンプレート)
floor(std::chrono::time_point) (C++17)	time_point を別の time_point に切り捨て変換します (関数テンプレート)
ceil(std::chrono::time_point) (C++17)	time_point を別の time_point に切り上げ変換します (関数テンプレート)
round(std::chrono::time_point) (C++17)	time_point を別の time_point の最も近い値に変換します (関数テンプレート)
リテラル
名前空間 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 リテラル (関数)
operator""d (C++20)	日を表す std::chrono::day リテラル (関数)
operator""y (C++20)	特定の年を表す std::chrono::year リテラル (関数)

概要

namespace std {namespace chrono {// class template durationtemplate<class Rep, class Period = ratio<1>>class duration;// class template time_pointtemplate<class Clock, class Duration =typename Clock::duration>class time_point;}// common_type specializationstemplate<class Rep1, class Period1, class Rep2, class Period2>struct common_type<chrono::duration<Rep1, Period1>, chrono::duration<Rep2, Period2>>;template<class Clock, class Duration1, class Duration2>struct common_type<chrono::time_point<Clock, Duration1>, chrono::time_point<Clock, Duration2>>;namespace chrono {// customization traitstemplate<class Rep>struct treat_as_floating_point;template<class Rep>struct duration_values;template<class Rep>constexprbool treat_as_floating_point_v = treat_as_floating_point<Rep>::value;// duration arithmetictemplate<class Rep1, class Period1, class Rep2, class Period2> common_type_t<duration<Rep1, Period1>, duration<Rep2, Period2>>constexpr operator+(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2> common_type_t<duration<Rep1, Period1>, duration<Rep2, Period2>>constexpr operator-(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period, class Rep2> duration<common_type_t<Rep1, Rep2>, Period>constexpr operator*(const duration<Rep1, Period>& d, const Rep2& s);template<class Rep1, class Rep2, class Period> duration<common_type_t<Rep1, Rep2>, Period>constexpr operator*(const Rep1& s, const duration<Rep2, Period>& d);template<class Rep1, class Period, class Rep2> duration<common_type_t<Rep1, Rep2>, Period>constexpr operator/(const duration<Rep1, Period>& d, const Rep2& s);template<class Rep1, class Period1, class Rep2, class Period2> common_type_t<Rep1, Rep2>constexpr operator/(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period, class Rep2> duration<common_type_t<Rep1, Rep2>, Period>constexpr operator%(const duration<Rep1, Period>& d, const Rep2& s);template<class Rep1, class Period1, class Rep2, class Period2> common_type_t<duration<Rep1, Period1>, duration<Rep2, Period2>>constexpr operator%(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);// duration comparisonstemplate<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator==(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator!=(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator<(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator<=(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator>(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Rep2, class Period2>constexprbool operator>=(const duration<Rep1, Period1>& lhs, const duration<Rep2, Period2>& rhs);// duration_casttemplate<class ToDuration, class Rep, class Period>constexpr ToDuration duration_cast(const duration<Rep, Period>& d);template<class ToDuration, class Rep, class Period>constexpr ToDuration floor(const duration<Rep, Period>& d);template<class ToDuration, class Rep, class Period>constexpr ToDuration ceil(const duration<Rep, Period>& d);template<class ToDuration, class Rep, class Period>constexpr ToDuration round(const duration<Rep, Period>& d);// convenience typedefsusing nanoseconds = duration</*signed integer type of at least 64 bits*/ , nano>;using microseconds = duration</*signed integer type of at least 55 bits*/ , micro>;using milliseconds = duration</*signed integer type of at least 45 bits*/ , milli>;using seconds = duration</*signed integer type of at least 35 bits*/>;using minutes = duration</*signed integer type of at least 29 bits*/ , ratio<60>>;using hours = duration</*signed integer type of at least 23 bits*/ , ratio<3600>>;// time_point arithmetictemplate<class Clock, class Duration1, class Rep2, class Period2>constexpr time_point<Clock, common_type_t<Duration1, duration<Rep2, Period2>>> operator+(const time_point<Clock, Duration1>& lhs, const duration<Rep2, Period2>& rhs);template<class Rep1, class Period1, class Clock, class Duration2>constexpr time_point<Clock, common_type_t<duration<Rep1, Period1>, Duration2>> operator+(const duration<Rep1, Period1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Rep2, class Period2>constexpr time_point<Clock, common_type_t<Duration1, duration<Rep2, Period2>>> operator-(const time_point<Clock, Duration1>& lhs, const duration<Rep2, Period2>& rhs);template<class Clock, class Duration1, class Duration2>constexpr common_type_t<Duration1, Duration2> operator-(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);// time_point comparisonstemplate<class Clock, class Duration1, class Duration2>constexprbool operator==(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Duration2>constexprbool operator!=(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Duration2>constexprbool operator<(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Duration2>constexprbool operator<=(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Duration2>constexprbool operator>(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);template<class Clock, class Duration1, class Duration2>constexprbool operator>=(const time_point<Clock, Duration1>& lhs, const time_point<Clock, Duration2>& rhs);// time_point_casttemplate<class ToDuration, class Clock, class Duration>constexpr time_point<Clock, ToDuration> time_point_cast(const time_point<Clock, Duration>& t);template<class ToDuration, class Clock, class Duration>constexpr time_point<Clock, ToDuration> floor(const time_point<Clock, Duration>& tp);template<class ToDuration, class Clock, class Duration>constexpr time_point<Clock, ToDuration> ceil(const time_point<Clock, Duration>& tp);template<class ToDuration, class Clock, class Duration>constexpr time_point<Clock, ToDuration> round(const time_point<Clock, Duration>& tp);// specialized algorithmstemplate<class Rep, class Period>constexpr duration<Rep, Period> abs(duration<Rep, Period> d);// clocksclass system_clock;class steady_clock;class high_resolution_clock;}inlinenamespace literals {inlinenamespace chrono_literals {// suffixes for duration literalsconstexpr chrono::hours operator "" h(unsignedlonglong);constexpr chrono::duration</*unspecified*/, ratio<3600,1>> operator "" h(longdouble);constexpr chrono::minutes operator "" min(unsignedlonglong);constexpr chrono::duration</*unspecified*/, ratio<60,1>> operator "" min(longdouble);constexpr chrono::seconds operator "" s(unsignedlonglong);constexpr chrono::duration</*unspecified*/> operator "" s(longdouble);constexpr chrono::milliseconds operator "" ms(unsignedlonglong);constexpr chrono::duration</*unspecified*/, milli> operator "" ms(longdouble);constexpr chrono::microseconds operator "" us(unsignedlonglong);constexpr chrono::duration</*unspecified*/, micro> operator "" us(longdouble);constexpr chrono::nanoseconds operator "" ns(unsignedlonglong);constexpr chrono::duration</*unspecified*/, nano> operator "" ns(longdouble);constexpr chrono::day operator""d(unsignedlonglong d)noexcept;constexpr chrono::year operator""y(unsignedlonglong y)noexcept;}}namespace chrono {usingnamespace literals::chrono_literals;}

std::chrono::treat_as_floating_point

template<class Rep>struct treat_as_floating_point : is_floating_point<Rep>{};

std::chrono::duration_values

template<class Rep>struct duration_values {public:staticconstexpr Rep zero();staticconstexpr Rep min();staticconstexpr Rep max();};

std::chrono::duration

template<class Rep, class Period = ratio<1>>class duration {public:using rep = Rep;using period = Period;private: rep rep_;// exposition onlypublic:// construct/copy/destroyconstexpr duration()=default;template<class Rep2>constexprexplicit duration(const Rep2& r);template<class Rep2, class Period2>constexpr duration(const duration<Rep2, Period2>& d); ~duration()=default; duration(const duration&)=default; duration& operator=(const duration&)=default;// observerconstexpr rep count()const;// arithmeticconstexpr duration operator+()const;constexpr duration operator-()const;constexpr duration& operator++();constexpr duration operator++(int);constexpr duration& operator--();constexpr duration operator--(int);constexpr duration& operator+=(const duration& d);constexpr duration& operator-=(const duration& d);constexpr duration& operator*=(const rep& rhs);constexpr duration& operator/=(const rep& rhs);constexpr duration& operator%=(const rep& rhs);constexpr duration& operator%=(const duration& rhs);// special valuesstaticconstexpr duration zero();staticconstexpr duration min();staticconstexpr duration max();};

std::chrono::time_point

template<class Clock, class Duration =typename Clock::duration>class time_point {public:using clock = Clock;using duration = Duration;using rep =typename duration::rep;using period =typename duration::period;private: duration d_;// exposition onlypublic:// constructconstexpr time_point();// has value epochconstexprexplicit time_point(const duration& d);// same as time_point() + dtemplate<class Duration2>constexpr time_point(const time_point<clock, Duration2>& t);// observerconstexpr duration time_since_epoch()const;// arithmeticconstexpr time_point& operator+=(const duration& d);constexpr time_point& operator-=(const duration& d);// special valuesstaticconstexpr time_point min();staticconstexpr time_point max();};

std::chrono::system_clock

class system_clock {public:using rep =/*see description*/;using period = ratio</*unspecified*/, /*unspecified*/>;using duration = chrono::duration<rep, period>;using time_point = chrono::time_point<system_clock>;staticconstexprbool is_steady =/*unspecified*/;static time_point now()noexcept;// Map to C APIstatic time_t to_time_t (const time_point& t)noexcept;static time_point from_time_t(time_t t)noexcept;};

std::chrono::steady_clock

class steady_clock {public:using rep =/*unspecified*/;using period = ratio</*unspecified*/, /*unspecified*/>;using duration = chrono::duration<rep, period>;using time_point = chrono::time_point</*unspecified*/, duration>;staticconstexprbool is_steady =true;static time_point now()noexcept;};

std::chrono::high_resolution_clock

class high_resolution_clock {public:using rep =/*unspecified*/;using period = ratio</*unspecified*/, /*unspecified*/>;using duration = chrono::duration<rep, period>;using time_point = chrono::time_point</*unspecified*/, duration>;staticconstexprbool is_steady =/*unspecified*/;static time_point now()noexcept;};