20 General utilities library [utilities]

20.17 Time utilities [time]

20.17.5 Class template duration [time.duration]

20.17.5.7 duration_cast [time.duration.cast]

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

1

Remarks: This function shall not participate in overload resolution unless ToDuration is a specialization of duration.

2

Returns: Let CF be ratio_divide<Period, typename ToDuration::period>, and CR be common_type< typename ToDuration::rep, Rep, intmax_t>::type.

  • (2.1)

    If CF::num == 1 and CF::den == 1, returns 

    ToDuration(static_cast<typename ToDuration::rep>(d.count()))
  • (2.2)

    otherwise, if CF::num != 1 and CF::den == 1, returns 

    ToDuration(static_cast<typename ToDuration::rep>(
  static_cast<CR>(d.count()) * static_cast<CR>(CF::num)))
  • (2.3)

    otherwise, if CF::num == 1 and CF::den != 1, returns 

    ToDuration(static_cast<typename ToDuration::rep>(
  static_cast<CR>(d.count()) / static_cast<CR>(CF::den)))
  • (2.4)

    otherwise, returns 

    ToDuration(static_cast<typename ToDuration::rep>(
  static_cast<CR>(d.count()) * static_cast<CR>(CF::num) / static_cast<CR>(CF::den)))

Notes: This function does not use any implicit conversions; all conversions are done with static_cast. It avoids multiplications and divisions when it is known at compile time that one or more arguments is 1. Intermediate computations are carried out in the widest representation and only converted to the destination representation at the final step.

template <class ToDuration, class Rep, class Period> constexpr ToDuration floor(const duration<Rep, Period>& d);

3

Remarks: This function shall not participate in overload resolution unless ToDuration is a specialization of duration.

4

Returns: The greatest result t representable in ToDuration for which t <= d.

template <class ToDuration, class Rep, class Period> constexpr ToDuration ceil(const duration<Rep, Period>& d);

5

Remarks: This function shall not participate in overload resolution unless ToDuration is a specialization of duration.

6

Returns: The least result t representable in ToDuration for which t >= d.

template <class ToDuration, class Rep, class Period> constexpr ToDuration round(const duration<Rep, Period>& d);

7

Remarks: This function shall not participate in overload resolution unless ToDuration is a specialization of duration, and treat_as_floating_point_v<typename ToDuration::rep> is false.

8

Returns: The value of ToDuration that is closest to d. If there are two closest values, then return the value t for which t % 2 == 0.