- chrono[meta header]
- std::chrono[meta namespace]
- class[meta id-type]
- cpp20[meta cpp]
namespace std::chrono {
template <class Duration, class TimeZonePtr = const time_zone*>
class zoned_time;
using zoned_seconds = zoned_time<seconds>;
}
- time_zone[link time_zone.md]
zoned_timeは、タイムゾーンを考慮した時間軸上の一点を表す型である。この型は、テンプレートパラメータとして時間間隔をとる。
秒単位の時間間隔を扱う別名として、zoned_secondsも定義される。
zoned_timeはtime_pointとtime_zoneの組である。有効なタイムゾーンを常にもち、あいまいなタイムゾーンを参照するようなことにはならないという不変条件をもつ。
このクラスを介することで、UTCタイムゾーンをもつシステム時間を指定したタイムゾーンのローカル時間に変換でき、またその逆の変換もできる。
このクラスに対する出力ストリームの演算子は、タイムゾーンを考慮したローカル時間を出力するため、単にタイムゾーンを考慮した日時を出力したい場合にも使用できる。
- テンプレートパラメータ
Durationがdurationクラスの特殊化であること
| 名前 |
説明 |
対応バージョン |
operator== |
等値比較を行う |
C++20 |
template<class Duration1, class Duration2, class TimeZonePtr>
bool operator!=(const zoned_time<Duration1, TimeZonePtr>& x, const zoned_time<Duration2, TimeZonePtr>& y); |
非等値比較を行う (==により使用可能) |
C++20 |
#include <iostream>
#include <chrono>
namespace chrono = std::chrono;
int main()
{
// システム時間はUTCタイムゾーンをもつ
auto now = chrono::system_clock::now();
chrono::sys_seconds now_sec = chrono::floor<chrono::seconds>(now); // 秒単位
// タイムゾーン情報なしで日時を出力する
// (ローカルタイムゾーンへの変換はしてくれないので、デフォルトではUTCタイムゾーンで出力される)
std::cout << "1 : " << now << std::endl;
// タイムゾーン付きで日時を出力する
std::cout << "2 : " << chrono::zoned_time{now} << std::endl; // デフォルトタイムゾーン (UTC)
std::cout << "3 : " << chrono::zoned_time{"Asia/Tokyo", now} << std::endl; // 日本 (UTC + 9時間)
std::cout << "4 : " << chrono::zoned_time{"UTC", now} << std::endl; // UTC
std::cout << "5 : " << chrono::zoned_time{"Asia/Tokyo", now_sec} << std::endl; // 日本 (秒単位)
// コンピュータに設定されているタイムゾーンで、日時を出力する
std::cout << "6 : " << chrono::zoned_time{chrono::current_zone(), now} << std::endl;
// UTCタイムゾーンのシステム時間を、日本のローカル時間に変換
chrono::local_time lt = chrono::zoned_time{"Asia/Tokyo", now}.get_local_time();
std::cout << "7 : "lt << std::endl;
}
- chrono::zoned_time[color ff0000]
- chrono::system_clock[link system_clock.md]
- now()[link system_clock/now.md]
- chrono::sys_seconds[link sys_time.md]
- chrono::floor[link time_point/floor.md]
- chrono::current_zone()[link current_zone.md]
- chrono::local_time[link local_time.md]
- get_local_time[link zoned_time/get_local_time.md]
1 : 2019-12-20 10:05:05
2 : 2019-12-20 10:05:05.330140 UTC
3 : 2019-12-20 19:05:05.330140 JST
4 : 2019-12-20 10:05:05.330140 UTC
5 : 2019-12-20 19:05:05 JST
6 : 2019-12-20 19:05:05.330140 JST
7 : 2019-12-20 19:05:05
#include <iostream>
#include <chrono>
#include <format>
namespace chrono = std::chrono;
int main()
{
// システム時間はUTCタイムゾーンをもつ
auto now = chrono::system_clock::now();
chrono::sys_seconds now_sec = chrono::floor<chrono::seconds>(now); // 秒単位
chrono::zoned_time zt{"Asia/Tokyo", now};
chrono::zoned_seconds zt_sec{"Asia/Tokyo", now_sec};
// デフォルトフォーマット
std::cout << std::format("1 : {}", zt) << std::endl;
std::cout << std::format("2 : {}", zt_sec) << std::endl;
// 「年月日 時分秒」のフォーマット
std::cout << std::format("3 : {:%Y年%m月%d日 %H時%M分%S秒}", zt_sec) << std::endl;
// 日付を / (スラッシュ) 区切り、時間を : (コロン) 区切り
std::cout << std::format("4 : {0:%Y/%m/%d %H:%M:%S}", zt_sec) << std::endl;
// 日付だけ出力
std::cout << std::format("5 : %Y年%m月%d日", zt_sec) << std::endl;
std::cout << std::format("6 : %F", zt_sec) << std::endl;
// 時間だけ出力
std::cout << std::format("7 : %H時%M分%S秒", zt_sec) << std::endl;
std::cout << std::format("8 : %T", zt_sec) << std::endl;
// 12時間時計で出力
// (%pでロケール固有の「午前」「午後」を出力するには、日本のロケールを指定する必要がある)
std::cout << std::format(std::locale("ja_JP.UTF-8"), "9 : %Y年%m月%d日 %p %I時%M分%S秒", zt_sec) << std::endl;
}
- chrono::zoned_time[color ff0000]
- chrono::zoned_seconds[color ff0000]
- chrono::system_clock[link system_clock.md]
- now()[link system_clock/now.md]
- chrono::sys_seconds[link sys_time.md]
- chrono::floor[link time_point/floor.md]
- std::format[link format.md]
- std::locale[link /reference/locale/locale.md]
1 : 2019-12-20 19:05:05.330140 JST
2 : 2019-12-20 19:05:05 JST
3 : 2019年12月20日 19時05分05秒
4 : 2019/12/20 19:05:05
5 : 2019年12月20日
6 : 2019-12-20
7 : 19時05分05秒
8 : 19:05:05
9 : 2019年12月20日 午後 07時05分05秒