std::chrono::clock_time_conversion(C++20)

namespace std::chrono {
  // (1) C++20
  template <class DestClock, class SourceClock>
  struct clock_time_conversion {};

  // (2) C++20
  template <class Clock>
  struct clock_time_conversion<Clock, Clock> {
    template <class Duration>
    time_point<Clock, Duration>
      operator()(const time_point<Clock, Duration>& t) const;

  // (3) C++20
  template <>
  struct clock_time_conversion<system_clock, system_clock> {
    template <class Duration>
    sys_time<Duration>
      operator()(const sys_time<Duration>& t) const;
  };

  // (4) C++20
  template <>
  struct clock_time_conversion<utc_clock, utc_clock> {
    template <class Duration>
    utc_time<Duration>
      operator()(const utc_time<Duration>& t) const;
  };

  // (5) C++20
  template <>
  struct clock_time_conversion<utc_clock, system_clock> {
    template<class Duration>
    utc_time<common_type_t<Duration, seconds>>
      operator()(const sys_time<Duration>& t) const;
  };

  // (6) C++20
  template <>
  struct clock_time_conversion<system_clock, utc_clock> {
    template <class Duration>
    sys_time<common_type_t<Duration, seconds>>
      operator()(const utc_time<Duration>& t) const;
  };

  // (7) C++20
  template <class SourceClock>
  struct clock_time_conversion<system_clock, SourceClock> {
    template <class Duration>
    auto operator()(const time_point<SourceClock, Duration>& t) const
      -> decltype(SourceClock::to_sys(t));
  };

  // (8) C++20
  template <class DestClock>
  struct clock_time_conversion<DestClock, system_clock> {
    template <class Duration>
    auto operator()(const sys_time<Duration>& t) const
      -> decltype(DestClock::from_sys(t));
  };

  // (9) C++20
  template <class SourceClock>
  struct clock_time_conversion<utc_clock, SourceClock> {
    template <class Duration>
    auto operator()(const time_point<SourceClock, Duration>& t) const
      -> decltype(SourceClock::to_utc(t));
  };

  // (10) C++20
  template <class DestClock>
  struct clock_time_conversion<DestClock, utc_clock> {
    template <class Duration>
    auto operator()(const utc_time<Duration>& t) const
      -> decltype(DestClock::from_utc(t));
  };
}

概要

clock_time_conversionは、clock_cast()関数内で、時計間の変換方法を組み合わせごとに定義するためのクラスである。

クラスの第1テンプレートパラメータは変換先の時計型、第2テンプレートパラメータは変換元の時計型を意味する。

(1) : プライマリテンプレート。関数呼び出し演算子は定義されない
(2) : 変換元と変換先の時計型が同じ場合。変換せずにそのまま返す
(3) : 変換元と変換先がどちらもsystem_clockの場合。変換せずにそのまま返す
(4) : 変換元と変換先がどちらもutc_clockの場合。変換せずにそのまま返す
(5) : system_clockからutc_clockに変換する
(6) : utc_clockからsystem_clockに変換する
(7) : 任意の時計型からsystem_clockに変換する
(8) : system_clockから任意の時計型に変換する
(9) : 任意の時計型 (system_clock以外) からutc_clockに変換する
(10) : utc_clockから任意の時計型 (system_clock以外) に変換する

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

(7) :
- 式DestClock::from_sys(t)が妥当でない場合、関数呼び出し演算子のオーバーロード解決に参加しない
- Durationがchrono::durationの特殊化でない場合、プログラムは不適格となる
(8) :
- 式SourceClock::to_sys(t)が妥当でない場合、関数呼び出し演算子のオーバーロード解決に参加しない
- Durationがchrono::durationの特殊化でない場合、プログラムは不適格となる
(9) :
- 式SourceClock::to_utc(t)が妥当でない場合、関数呼び出し演算子のオーバーロード解決に参加しない
- Durationがchrono::durationの特殊化でない場合、プログラムは不適格となる
(10) :
- 式DestClock::from_utc(t)が妥当でない場合、関数呼び出し演算子のオーバーロード解決に参加しない
- Durationがchrono::durationの特殊化でない場合、プログラムは不適格となる

戻り値

関数呼び出し演算子の戻り値を以下に記述する。

(2), (3), (4) :
```
return t;
```
(5) :
```
return utc_clock::from_sys(t);
```
(6) :
```
return utc_clock::to_sys(t);
```
(7) :
```
return SourceClock::to_sys(t);
```
(8) :
```
return DestClock::from_sys(t);
```

備考

system_clockとutc_clockの間の変換は、utc_clockクラスの機能を使用して変換する
tai_clock、gps_clockとutc_clockの間の変換は、tai_clockとgps_clockの機能を使用して変換する
tai_clock、gps_clockとsystem_clockの直接の変換は定義されないため、utc_clockを介して変換することはできないが、clock_cast()関数ではそのような変換がサポートされる

例

#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
  // system_clockからutc_clockへの変換
  {
    utc_time ut = clock_time_conversion<utc_clock, system_clock>{}(system_clock::now());
    std::cout << ut << std::endl;
  }

  // system_clockからutc_clockへの変換
  {
    sys_time st = clock_time_conversion<system_clock, utc_clock>{}(utc_clock::now());
    std::cout << st << std::endl;
  }

  // utc_clockからtai_clockへの変換
  {
    tai_time tt = clock_time_conversion<tai_clock, utc_clock>{}(utc_clock::now());
    std::cout << tt << std::endl;
  }

  // tai_clockからutc_clockへの変換
  {
    utc_time ut = clock_time_conversion<utc_clock, tai_clock>{}(tai_clock::now());
    std::cout << ut << std::endl;
  }
}

出力例

2019-10-24 11:15:10 UTC
2019-10-24 11:15:10
2019-10-24 11:15:37 TAI
2019-10-24 11:15:10 UTC

std::chrono::clock_time_conversion(C++20)

概要

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

戻り値

備考

例

出力例

バージョン

言語

処理系