• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

    最終更新日時(UTC):
    が更新

    履歴 編集

    type-alias
    <chrono>

    std::chrono::sys_time

    namespace std::chrono {
      template <class Duration>
      using sys_time = time_point<system_clock, Duration>; // (1) C++20
    
      using sys_seconds = sys_time<seconds>;               // (2) C++20
      using sys_days    = sys_time<days>;                  // (3) C++20
    
      template <class charT, class traits, class Duration>
      std::basic_ostream<charT, traits>&
        operator<<(std::basic_ostream<charT, traits>& os,
                   const sys_time<Duration>& tp);          // (4) C++20
    
      template <class charT, class traits>
      std::basic_ostream<charT, traits>&
        operator<<(std::basic_ostream<charT, traits>& os,
                   const sys_days& dp);                    // (5) C++20
    
      template <class charT, class traits, class Duration, class Alloc = std::allocator<charT>>
      std::basic_istream<charT, traits>&
        from_stream(std::basic_istream<charT, traits>& is,
                    const charT* fmt,
                    sys_time<Duration>& tp,
                    std::basic_string<charT, traits, Alloc>* abbrev = nullptr,
                    minutes* offset = nullptr);            // (6) C++20
    }
    
    namespace std {
      template <class Duration, class charT>
      struct formatter<chrono::sys_time<Duration>, charT>; // (7) C++20
    }
    

    概要

    システム時間の一点を指すtime_pointに対する別名。

    • (1) : system_clocktime_pointに対する別名。時間間隔を表す型はパラメータ化されている
    • (2) : 秒単位でシステム時間の一点を指すtime_pointに対する別名
    • (3) : 日単位でシステム時間の一点を指すtime_pointに対する別名
    • (4) : 時間点に含まれる日付と時間を出力ストリームに出力する
    • (5) : 時間点に含まれる日付を出力ストリームに出力する
    • (6) : フォーマット指定して入力ストリームから日付・時間を時間点オブジェクトに入力する
    • (7) : sys_time型に対するstd::formatterクラステンプレートの特殊化

    テンプレートパラメータ制約

    効果

    便宜上のリテラルキャストSTATICALLY-WIDENを導入する。STATICALLY-WIDEN<charT>("...")は、charTcharである場合は"..."charTwchar_tである場合はL"..."を意味する。

    • (4) : 以下と等価:

      auto const dp = floor<days>(tp);
      return os << format(os.getloc(), STATICALLY-WIDEN<charT>("{:L} {:L}"),
                          year_month_day{dp}, hh_mm_ss{tp - dp});
      

    • (5) : 以下と等価:

      return os << year_month_day{dp};
      

    • (6) :

      • パラメータfmtで指定されたフォーマットフラグを使用して、入力を解析し、tpに代入する
      • 有効な日付・時間の解析に失敗した場合、is.setstate(ios_base::failbit)が呼び出され、パラメータtpは変更されない
      • タイムゾーンフォーマット"%Z"が指定され、解析が成功した場合、パラメータabbrevが非ヌルである場合に*abbrevにタイムゾーン名が代入される
      • タイムゾーンとしてUTC時間からのオフセット時間 (日本なら"+0900") を意味するフォーマット"%z"が指定され、解析が成功した場合、パラメータoffsetが非ヌルである場合に*offsetにその値が代入される
      • さらに、tpに日付・時間が代入される前に、解析されたオフセットがタイムスタンプから引かれる
      • isを返す

    備考

    • (1) : このバージョンは、関数テンプレートで任意の時間間隔単位のtime_pointを受け取るために使用できる。system_clock::time_pointがもつ時間間隔の単位は未規定 (実装定義) であり、特定の単位に決めることができないため、時間間隔の型のみをパラメータ化して関数テンプレートで受け取ると便利である
    • yearクラスの制限により、年の値としては[-32767, 32767]の範囲までしか入出力できないことに注意 (その範囲外は未規定の値となる)
    • (4), (5) : 出力ストリームの演算子は、ローカルのタイムゾーンへの変換を行わない。そのため、システム時間をそのまま出力すると、デフォルトではUTCタイムゾーンの日時が出力される。日本のタイムゾーンで出力したい場合は、zoned_timeクラスを介して出力するか、9時間を加算して出力すること
    • (7) :
      • %Z (タイムゾーンの略称) が指定された場合、STATICALLY-WIDEN<charT>("UTC")で置き換えられる
      • %zもしくはその改良コマンドが指定された場合、0minが使用される

    基本的な使い方

    #include <iostream>
    #include <chrono>
    
    namespace chrono = std::chrono;
    using namespace std::chrono_literals;
    
    int main()
    {
      // 未規定の時間間隔単位をもつ時間点
      chrono::system_clock::time_point now = chrono::system_clock::now();
    
      // 秒単位の時間点 (UTCタイムゾーンで日付と時間が出力される)
      chrono::sys_seconds sec_tp = chrono::floor<chrono::seconds>(now);
      std::cout << sec_tp << std::endl;
    
      // 日単位の時間点 (UTCタイムゾーンで日付が出力される)
      chrono::sys_days day_tp = chrono::floor<chrono::days>(now);
      std::cout << day_tp << std::endl;
    
      // 以下は、日本のタイムゾーンで日時を出力する方法:
      // 1. コンピュータに設定されたタイムゾーンで日時を出力
      std::cout << chrono::zoned_time{chrono::current_zone(), now} << std::endl;
      // 2. 日本のタイムゾーン (UTC + 9時間) で日時を出力
      std::cout << chrono::zoned_time{"Asia/Tokyo", now} << std::endl;
    
      // year_month_dayオブジェクトからシステム時間を構築
      chrono::sys_days sd{2020y/3/1};
      std::cout << sd << std::endl;
    
      // sys_daysに時・分などを加算すると、それらの分解能を扱えるsys_time<Duration>に変換される
      chrono::sys_time<chrono::minutes> sm = chrono::sys_days{2020y/3/1} + 15h + 30min;
      std::cout << sm << std::endl;
    }
    

    出力例

    2019-10-24 11:15:10
    2019-10-24
    2019-10-24 20:15:10.330140 JST
    2019-10-24 20:15:10.330140 JST
    2020-03-01
    2020-03-01 15:30:00
    

    入力の例

    #include <iostream>
    #include <sstream>
    #include <chrono>
    
    namespace chrono = std::chrono;
    
    int main()
    {
      // タイムゾーンとオフセットを含まない入力
      {
        std::stringstream ss;
        ss << "2019-10-24 20:15:10";
    
        chrono::sys_seconds tp;
        chrono::from_stream(ss, "%Y-%m-%d %H:%M:%S", tp);
    
        if (ss) {
          std::cout << tp << std::endl;
        }
        else {
          std::cout << "解析失敗" << std::endl;
        }
      }
    
      // タイムゾーンとオフセットを含む入力
      {
        std::stringstream ss;
        ss << "2019-10-24 20:15:10 JST+0900";
    
        chrono::sys_seconds tp;
        std::string abbrev;
        chrono::minutes offset{0};
        chrono::from_stream(ss, "%Y-%m-%d %H:%M:%S %Z%z", tp, &abbrev, &offset);
    
        std::cout << tp << std::endl;
        std::cout << abbrev << std::endl;
        std::cout << offset.count() << std::endl;
      }
    }
    

    出力例

    2019-10-24 20:15:10
    2019-10-24 11:15:10
    JST
    540
    

    文字列フォーマットの例

    #include <iostream>
    #include <chrono>
    #include <format>
    
    namespace chrono = std::chrono;
    
    int main()
    {
      chrono::system_clock::time_point now = chrono::system_clock::now();
      chrono::sys_seconds now_sec = chrono::floor<chrono::seconds>(tp);
    
      // デフォルトフォーマット
      std::cout << std::format("1 : {}", now_sec) << std::endl;
    
      // 「年月日 時分秒」のフォーマット
      std::cout << std::format("2 : {:%Y年%m月%d日 %H時%M分%S秒}", now_sec) << std::endl;
    
      // 日付を / (スラッシュ) 区切り、時間を : (コロン) 区切り、タイムゾーンの略称付き
      std::cout << std::format("3 : {0:%Y/%m/%d %H:%M:%S %Z}", now_sec) << std::endl;
    
      // 日付だけ出力
      std::cout << std::format("4 : %Y年%m月%d日", now_sec) << std::endl;
      std::cout << std::format("5 : %F", now_sec) << std::endl;
    
      // 時間だけ出力
      std::cout << std::format("6 : %H時%M分%S秒", now_sec) << std::endl;
      std::cout << std::format("7 : %T", now_sec) << std::endl;
    }
    

    出力例

    1 : 2019-12-20 10:05:05 UTC
    2 : 2019年12月20日 10時05分05秒
    3 : 2019/12/20 10:05:05 UTC
    4 : 2019年12月20日
    5 : 2019-12-20
    6 : 10時05分05秒
    7 : 10:05:05
    

    バージョン

    言語

    • C++20

    処理系

    • Clang: 8.0 (入出力ストリームなし)
    • GCC: 9.2
    • Visual C++: 2019 Update 3

    関連項目

    参照