Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::chrono::is_clock

If T satisfies the Clock requirements, provides the member constant value equal true. For any other type, value is false.

NotebookLM
Defined in header <chrono>
template< class T >
struct is_clock;
(since C++20)

If T satisfies the Clock requirements, provides the member constant value equal true. For any other type, value is false.

For the purpose of this trait, the extent to which an implementation determines that a type cannot meet the Clock requirements is unspecified, except that a minimum T shall not qualify as a Clock unless it meets all following conditions:

  • T::rep
  • T::period
  • T::duration
  • T::time_point
  • T::is_steady
  • T::now()

If the program adds specializations for std::is_clock or std::is_clock_v, the behavior is undefined.

Template parameters

T - a type to check

Helper variable template

template< class T >
constexpr bool is_clock_v = is_clock<T>::value;
(since C++20)

Inherited from std::integral_constant

Member constants

value
[static]
true if T satisfies the Clock requirements, false otherwise
(public static member constant)

Member functions

operator bool
converts the object to bool, returns value
(public member function)
operator()
(C++14)
returns value
(public member function)

Member types

Type Definition
value_type bool
type std::integral_constant<bool, value>

Possible implementation

snippet.cpp
template<class>
struct is_clock : std::false_type {};
 
template<class T>
    requires
        requires
        {
            typename T::rep;
            typename T::period;
            typename T::duration;
            typename T::time_point;
            T::is_steady; // type is not checked
            T::now();     // return type is not checked
        }
struct is_clock<T> : std::true_type {};

Notes

If T otherwise meets the Clock requirements, but T::is_steady is not of type const bool, or T::now() is not of type T::time_point, the result of is_clock_v<T> is unspecified.

Example

example.cpp
#include <chrono>
#include <ratio>
 
static_assert
(
    std::chrono::is_clock_v<std::chrono::utc_clock> and
    not std::chrono::is_clock_v<std::chrono::duration<int, std::exa>>
);
 
int main() {}

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.