std::chrono::duration_cast

 

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

 

template <class ToDuration, class Rep, class Period> constexpr ToDuration duration_cast(const duration<Rep,Period>& d);		(since C++11)

Converts a std::chrono::duration to a duration of different type ToDuration.

No implicit conversions are used. Multiplications and divisions are avoided where possible, if it is known at compile time that one or more parameters are 1. Computations are done in the widest type available and converted to the result type only when finished.

Parameters

d

-

duration to convert

Return value

d converted to a duration of type ToDuration.

Notes

The function does not participate in the overload resolution unless ToDuration is an instance of std::chrono::duration.

Example

This example measures the execution time of a function

#include <iostream>
#include <chrono>
#include <thread>
 
void f()
{
    std::this_thread::sleep_for(std::chrono::seconds(1));
}
 
int main()
{
    auto t1 = std::chrono::high_resolution_clock::now();
    f();
    auto t2 = std::chrono::high_resolution_clock::now();
    std::cout << "f() took "
              << std::chrono::duration_cast<std::chrono::milliseconds>(t2-t1).count()
              << " milliseconds\n";
}

Output:

f() took 1000 milliseconds