名前空間
変種
操作

std::chrono::time_zone::to_sys

提供: cppreference.com
< cpp‎ | chrono‎ | time zone
 
C++
 
ユーティリティライブラリ
汎用ユーティリティ
日付と時間
関数オブジェクト
書式化ライブラリ (C++20)
(C++11)
(C++14)
関係演算子 (C++20で非推奨)
整数比較関数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
スワップと型操作
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
一般的な語彙の型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等文字列変換
(C++17)
(C++17)
(C++17)
 
日付と時間のユーティリティ
(C++11)
(C++11)
時刻
(C++20)



(C++20)(C++20)(C++20)(C++20)
時計
(C++11)
(C++11)
(C++11)
(C++20)
                                             
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
カレンダー
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
タイムゾーン
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
C スタイルの日付と時間
 
std::chrono::time_zone
メンバ関数
time_zone::to_sys
非メンバ関数
 
template< class Duration >

auto to_sys(const std::chrono::local_time<Duration>& tp) const

    -> std::chrono::sys_time<std::common_type_t<Duration, std::chrono::seconds>>;
 (C++20以上)
template< class Duration >

auto to_sys(const std::chrono::local_time<Duration>& tp, std::chrono::choose z) const

    -> std::chrono::sys_time<std::common_type_t<Duration, std::chrono::seconds>>;
 (C++20以上)

このタイムゾーンの local_time tp を対応する sys_time に変換します。

1) 変換が曖昧な場合、または tp が存在しない時間を表している場合、例外を投げます。
2) z の値に従って曖昧性を解決します。
  • z == std::chrono::choose::earliest であれば、早い方の sys_time を返します。
  • z == std::chrono::choose::latest であれば、遅い方の sys_time を返します。
tp が2つの UTC time_point 間の存在しない時間を表す場合、それら2つの time_point は同じであり、その time_point が返されます。

[編集] 戻り値

このタイムゾーンのルールに従った tp と同等の UTC。

[編集] 例外

1) 変換が曖昧な場合は std::chrono::ambiguous_local_time を投げます。 tp が存在しない時間の場合は std::chrono::nonexistent_local_time を投げます。

[編集] ノート

結果の精度は少なくとも std::chrono::seconds で、引数がより高い精度を持っていれば、より高くなります。

曖昧な時間や存在しない時間は、タイムゾーンの移行 (夏時間など) の結果として発生する場合があります。 例えば "America/New_York" のタイムゾーンでは、 2016-03-13 02:30:00 が存在しませんし、 2016-11-06 01:30:00 に対応する UTC の時間は 2016-11-06 05:30:00 UTC と 2016-11-06 06:30:00 UTC の2つがあります。

「https://ja.cppreference.com/mwiki/index.php?title=cpp/chrono/time_zone/to_sys&oldid=49168」から取得