std::chrono::duration::duration

 

C++

Language

Standard library headers

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-style date and time

 

std::chrono::duration

Member functions

duration::duration

duration::operator=

duration::count

duration::zero

duration::min

duration::max

duration::operator+ duration::operator-

duration::operator++ duration::operator--

duration::operator+= duration::operator-= duration::operator*= duration::operator/= duration::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

 

constexpr duration() = default;	(1)
duration(const duration&) = default;	(2)
template <class Rep2> constexpr explicit duration(const Rep2& r);	(3)
template <class Rep2, class Period2> constexpr duration(const duration<Rep2, Period2>& d);	(4)

Constructs a new duration from one of several optional data sources.

1) The default constructor is defaulted.

2) The copy constructor is defaulted (makes a bitwise copy of the tick count).

3) Constructs a duration with r ticks. Note that this constructor only participates in overload resolution if Rep2 (the argument type) is implicitly convertible to rep (the type of this duration's ticks) and

• std::chrono::treat_as_floating_point<rep>::value is true, or
• std::chrono::treat_as_floating_point<Rep2>::value is false.

(that is, a duration with an integer tick count cannot be constructed from a floating-point value, but a duration with a floating-point tick count can be constructed from an integer value)

4) Constructs a duration by converting d to an appropriate period and tick count, as if by std::chrono::duration_cast<duration>(d).count(). In order to prevent truncation during conversion, this constructor only participates in overload resolution if:

• std::chrono::treat_as_floating_point<rep>::value == true

or both:

• std::ratio_divide<Period2, period>::den == 1, and
• std::chrono::treat_as_floating_point<Rep2>::value == false.

(that is, either the duration uses floating-point ticks, or Period2 is exactly divisible by period)

Parameters

r	-	a tick count
d	-	a duration to copy from

Example

The following code shows several examples (both valid and invalid) of how to construct durations:

run this code

#include <chrono>
int main()
{
    std::chrono::hours h(1); // one hour
    std::chrono::milliseconds ms{3}; // 3 milliseconds
    std::chrono::duration<int, std::kilo> ks(3); // 3000 seconds
 
    // error: treat_as_floating_point<int>::value == false,
    // This duration allows whole tick counts only
//  std::chrono::duration<int, std::kilo> d3(3.5);
 
    // 30Hz clock using fractional ticks
    std::chrono::duration<double, std::ratio<1, 30>> hz30(3.5);
 
    // 3000 microseconds constructed from 3 milliseconds
    std::chrono::microseconds us = ms;
    // error: 1/1000000 is not divisible by 1/1000
//  std::chrono::milliseconds ms2 = us
}

See also

operator=	assigns the contents (public member function)