# std::hash<std::chrono::time_point>

> C++ Atlas: `cppatlas.com/w/cpp/chrono/time_point/hash` | Source: https://en.cppreference.com/w/cpp/chrono/time_point/hash | Domain: Date and time utilities | Standards: C++11, C++26

The template specialization of std::hash for std::chrono::time_point allows users to obtain hashes of objects of type std::chrono::time_point<Clock, Duration>.

## Official Specification Summary (cppreference)

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

template< class Clock, class Duration >
struct hash<std::chrono::time_point<Clock, Duration>>; // (since C++26)
```

The template specialization of `std::hash` for `std::chrono::time_point` allows users to obtain hashes of objects of type `std::chrono::time_point<Clock, Duration>`. This specialization is enabled if and only if `std::hash<Duration>` is enabled.

### Notes

| Feature-test macro | Value | Std | Feature |
| --- | --- | --- | --- |
| `__cpp_lib_chrono` | `202306L` | (C++26) | Hashing support for `std::chrono` value classes |

### Example

```cpp
#include <chrono>
#include <cstddef>
#include <iostream>
#include <string>
#include <thread>
#include <unordered_map>

struct my_system_clock : std::chrono::system_clock
{
    using time_point = std::chrono::time_point<my_system_clock>;

    static time_point now() noexcept
    {
        return time_point{std::chrono::system_clock::now().time_since_epoch()};
    }

    template<class CharT, class Traits>
    friend auto operator<<(std::basic_ostream<CharT, Traits>& os, const time_point& tp)
        -> decltype(os)
    {
        return os << std::chrono::system_clock::time_point{tp.time_since_epoch()};
    }
};

using my_system_clock_tp = std::chrono::time_point<my_system_clock>;

#if __cpp_lib_chrono < 202306L
// custom specialization of std::hash can be injected in namespace std
template<>
struct std::hash<my_system_clock_tp>
{
    std::size_t operator()(const my_system_clock_tp& d) const noexcept
    {
        return d.time_since_epoch().count();
    }
};
#endif

int main()
{
    using namespace std::chrono_literals;

    std::unordered_map<my_system_clock_tp, std::string> log;

    for (int i{}; i != 4; ++i)
    {
        std::this_thread::sleep_for(100ms);
        log[my_system_clock::now()] = "event #" + std::to_string(i);
    }

    for (auto const& [time, message] : log)
        std::cout << '[' << time << "], message: " << message << '\n';
}
```

Possible output:

```text
[2024-03-22 10:47:14.966238436], message: event #3
[2024-03-22 10:47:14.866096194], message: event #2
[2024-03-22 10:47:14.765965786], message: event #1
[2024-03-22 10:47:14.665817365], message: event #0
```

### See also

- [`hash`](https://en.cppreference.com/w/cpp/utility/hash) (C++11): hash function object (class template)

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