# std::chrono::clock_cast

> C++ Atlas: `cppatlas.com/w/cpp/chrono/clock_cast` | Source: https://en.cppreference.com/w/cpp/chrono/clock_cast | Domain: Date and time utilities | Standards: C++20

Converts the time point t of a clock Source to an equivalent time point of the clock Dest, using std::chrono::system_clock and/or std::chrono::utc_clock as intermediaries if necessary.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <chrono>

template< class Dest, class Source, class Duration >
auto clock_cast( const std::chrono::time_point<Source, Duration>& t ); // (since C++20)
```

Converts the time point `t` of a clock `Source` to an equivalent time point of the clock `Dest`, using `std::chrono::system_clock` and/or `std::chrono::utc_clock` as intermediaries if necessary.

- If the expression `std::chrono::clock_time_conversion<Dest, Source>{}(t)` is well-formed, returns the result of that expression.
- Otherwise, if at least one of the following two expressions are well-formed, then

  - If both expressions are well-formed, the conversion is ambiguous, and the program is ill-formed.
  - Otherwise, exactly one of the two expressions is well-formed; the result of that expression is returned.

  1) `std::chrono::clock_time_conversion<Dest, std::chrono::system_clock>{}(std::chrono::clock_time_conversion<std::chrono::system_clock, Source>{}(t))`

  2) `std::chrono::clock_time_conversion<Dest, std::chrono::utc_clock>{}(std::chrono::clock_time_conversion<std::chrono::utc_clock, Source>{}(t))`

- Otherwise, if at least one of the following two expressions are well-formed, then

  - If both expressions are well-formed, the conversion is ambiguous, and the program is ill-formed.
  - Otherwise, exactly one of the two expressions is well-formed; the result of that expression is returned.

  1) `std::chrono::clock_time_conversion<Dest, std::chrono::utc_clock>{}(std::chrono::clock_time_conversion<std::chrono::utc_clock, std::chrono::system_clock>{}(std::chrono::clock_time_conversion<std::chrono::system_clock, Source>{}(t)))`

  2) `std::chrono::clock_time_conversion<Dest, std::chrono::system_clock>{}(std::chrono::clock_time_conversion<std::chrono::system_clock, std::chrono::utc_clock>{}(std::chrono::clock_time_conversion<std::chrono::utc_clock, Source>{}(t)))`

- Otherwise, this function does not participate in overload resolution.

### Return value

The result of the conversion, determined as described above.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`clock_time_conversion`](https://en.cppreference.com/w/cpp/chrono/clock_time_conversion) (C++20): traits class defining how to convert time points of one clock to another (class template)

---
Attribution: content from https://en.cppreference.com/w/cpp/chrono/clock_cast (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.