std::chrono::duration

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Utilities library

Type support (basic types, RTTI, type traits)

Dynamic memory management

Error handling

Program utilities

Variadic functions

Date and time

Function objects

initializer_list (C++11)

bitset

hash (C++11)

Relational operators

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Pairs and tuples

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward and move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Date and time utilities

time_point (C++11)

duration (C++11)

system_clock (C++11)

steady_clock (C++11)

high_resolution_clock (C++11)

C library facilities

 

std::chrono::duration

Member functions

duration::duration

duration::operator=

duration::count

duration::zero

duration::min

duration::max

bitset::operator+ bitset::operator-

bitset::operator++ bitset::operator--

bitset::operator+= bitset::operator-= bitset::operator*= bitset::operator/= bitset::operator%=

Non-member functions

common_type

operator+ operator- operator* operator/ operator%

operator== operator!= operator< operator<= operator> operator>=

duration_cast

Helper classes

treat_as_floating_point

duration_values

 

Defined in header <chrono>
template<     class Rep,     class Period = std::ratio<1> > class duration;		(since C++11)

Class template std::chrono::duration represents a time interval.

It consists of a count of ticks and a tick period, where the tick period is a compile-time rational constant representing the number of seconds from one tick to the next.

Member types

Member type	Definition
rep	Rep, an arithmetic type representing the number of ticks
period	Period, a std::ratio representing the tick period (i.e. the number of seconds per tick)

Member functions

(constructor)	constructs new duration (public member function)
operator=	assigns the contents (public member function)
count	returns the count of ticks (public member function)
zero [static]	returns the special duration value zero (public static member function)
min [static]	returns the special duration value min (public static member function)
max [static]	returns the special duration value max (public static member function)
operator+ operator-	implements unary + and unary - (public member function)
operator++ operator++(int) operator-- operator--(int)	increments or decrements the tick count (public member function)
operator+= operator-= operator*= operator/= operator%=	implements compound assignment between two durations (public member function)

Non-member types

Type	Definition
std::chrono::nanoseconds	duration type with Period std::nano
std::chrono::microseconds	duration type with Period std::micro
std::chrono::milliseconds	duration type with Period std::milli
std::chrono::seconds	duration type with Period std::ratio<1>
std::chrono::minutes	duration type with Period std::ratio<60>
std::chrono::hours	duration type with Period std::ratio<3600>

Non-member functions

std::common_type<std::chrono::duration>	specializes the std::common_type trait (class template specialization)
operator+ operator- operator* operator/ operator%	implements arithmetic operations with durations as arguments (function template)
operator== operator!= operator< operator<= operator> operator>=	compares two durations (function template)
duration_cast	converts a duration to another, with a different tick interval (function template)

Helper classes

treat_as_floating_point	indicates that a duration is convertible to duration with different tick period (class template)
duration_values	constructs zero, min, and max values of a tick count of given type (class template)

Example

This example shows how to define several custom duration types and convert between types:

#include <iostream>
#include <chrono>
 
int main()
{
    typedef std::chrono::duration<int, std::ratio<1, 100000000>> shakes;
    typedef std::chrono::duration<int, std::centi> jiffies;
    typedef std::chrono::duration<float, std::ratio<12096,10000>> microfortnights;
    typedef std::chrono::duration<float, std::ratio<3155,1000>> nanocenturies;
 
    std::chrono::seconds sec(1);
 
    std::cout << "1 second is:\n";
 
    std::cout << std::chrono::duration_cast<shakes>(sec).count()
              << " shakes\n";
    std::cout << std::chrono::duration_cast<jiffies>(sec).count()
              << " jiffies\n";
    std::cout << std::chrono::duration_cast<microfortnights>(sec).count()
              << " microfortnights\n";
    std::cout << std::chrono::duration_cast<nanocenturies>(sec).count()
              << " nanocenturies\n";
}

Output:

1 second is:
100000000 shakes
100 jiffies
0.82672 microfortnights
0.316957 nanocenturies