Пространства имён
Варианты
Действия

std::chrono::round(std::chrono::duration)

Материал из cppreference.com
< cpp‎ | chrono‎ | duration
 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Библиотека утилит
Языковая поддержка
Поддержка типов (базовые типы, RTTI)
Макросы тестирования функциональности библиотеки (C++20)    
Управление динамической памятью
Программные утилиты
Поддержка сопрограмм (C++20)
Вариативные функции
(C++20)
(C++26)
(C++11)
(C++20)
Трёхстороннее сравнение (C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)    
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
Общие утилиты
Дата и время
Функциональные объекты
Библиотека форматирования (C++20)
(C++11)
Операторы отношения (устарело в C++20)
Целочисленные функции сравнения
(C++20)(C++20)(C++20)    
(C++20)
Операции обмена и типа
(C++20)
(C++14)
(C++11)
(C++23)
(C++11)
(C++23)
(C++11)
(C++11)
(C++17)
Общие лексические типы
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)
(C++23)
Элементарные преобразования строк
(C++17)
(C++17)
(C++17)
 
Функции работы с датой и временем
Момент времени
(C++11)
(C++20)
Длительность
(C++11)
Часы
(C++11)
(C++11)
(C++11)      
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Время суток
(C++20)(C++20)
(C++20)(C++20)
(C++20)

Календари
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
Часовые пояса
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
Ввод/Вывод chrono
(C++20)
Дата и время в стиле C
 
std::chrono::duration
Функции-элементы
Функции, не являющиеся элементами
(C++17)
(C++17)
round
(C++17)
(C++17)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++20)

Вспомогательные классы
 
Определено в заголовочном файле <chrono>
template <class ToDuration, class Rep, class Period>
constexpr ToDuration round( const std::chrono::duration<Rep, Period>& d );
 (начиная с C++17)

Возвращает значение t, представленное в ToDuration и наиболее близкое к d. Если таких значений два, возвращает чётное значение (то есть значение t такое, что t % 2 == 0).

Функция не участвует в разрешении перегрузки, если только ToDuration не является специализацией std::chrono::duration и std::chrono::treat_as_floating_point_v<typename ToDuration::rep> равно false

Содержание

[править] Параметры

d — длительность для преобразования

[править] Возвращаемое значение

d округляется до ближайшей длительности типа ToDuration, округляя до чётных в промежуточных случаях.

[править] Возможная реализация

namespace detail {
template<class> inline constexpr bool is_duration_v = false;
template<class Rep, class Period> inline constexpr bool is_duration_v<
    std::chrono::duration<Rep, Period>> = true;
}
 
template <class To, class Rep, class Period,
          class = std::enable_if_t<detail::is_duration_v<To> &&
                 !std::chrono::treat_as_floating_point_v<typename To::rep>>>
constexpr To round(const std::chrono::duration<Rep, Period>& d)
{
    To t0 = std::chrono::floor<To>(d);
    To t1 = t0 + To{1};
    auto diff0 = d - t0;
    auto diff1 = t1 - d;
    if (diff0 == diff1)
    {
        if (t0.count() & 1)
            return t1;
        return t0;
    }
    else if (diff0 < diff1)
        return t0;
    return t1;
}

[править] Пример

Запустить этот код
#include <iostream>
#include <iomanip>
#include <chrono>
 
int main()
{
    using namespace std::chrono_literals;
    std::cout << "Длительность\tПол\tОкругление\tПотолок\n";
    for (using Sec = std::chrono::seconds;
        auto const d : {+4999ms, +5000ms, +5001ms, +5499ms, +5500ms, +5999ms,
                        -4999ms, -5000ms, -5001ms, -5499ms, -5500ms, -5999ms})
        std::cout << std::showpos << d << "\t\t"
                  << std::chrono::floor<Sec>(d) << '\t'
                  << std::chrono::round<Sec>(d) << "\t\t"
                  << std::chrono::ceil <Sec>(d) << '\n';
}

Вывод: 

Длительность	Пол	Округление	Потолок
+4999ms		+4s	+5s		+5s
+5000ms		+5s	+5s		+5s
+5001ms		+5s	+5s		+6s
+5499ms		+5s	+5s		+6s
+5500ms		+5s	+6s		+6s
+5999ms		+5s	+6s		+6s
-4999ms		-5s	-5s		-4s
-5000ms		-5s	-5s		-5s
-5001ms		-6s	-5s		-5s
-5499ms		-6s	-5s		-5s
-5500ms		-6s	-6s		-5s
-5999ms		-6s	-6s		-5s

[править] Смотрите также

(C++11)
 преобразует duration в другой duration с другим интервалом тиков
(шаблон функции) [править]
(C++17)
 преобразует duration в другой, округляя в меньшую сторону
(шаблон функции) [править]
(C++17)
 преобразует duration в другой, округляя в большую сторону
(шаблон функции) [править]
(C++17)
 преобразует time_point в другой, округляя до ближайшего, или до чётного в промежуточных случаях
(шаблон функции) [править]
(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)
 ближайшее целое число, округление от нуля в промежуточных случаях
(функция) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/chrono/duration/round&oldid=62374»