std::chrono::round(std::chrono::time_point)

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека утилит

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20)     Управление динамической памятью Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)     is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)     cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

Функции работы с датой и временем

Момент времени
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
Длительность
duration (C++11)
Часы
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11)	is_clock (C++20) utc_clock (C++20) tai_clock (C++20)	gps_clock (C++20) file_clock (C++20) local_t (C++20)
Время суток
is_amis_pm (C++20)(C++20)	make12make24 (C++20)(C++20)	hh_mm_ss (C++20)
Календари
day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20)	year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)       weekday_indexed (C++20) weekday_last (C++20) month_day (C++20)	month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20)
Часовые пояса
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20)	local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20)	zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20)
Ввод/Вывод chrono
parse (C++20)
Дата и время в стиле C

 

std::chrono::time_point

Функции-элементы

time_point::time_point

time_point::time_since_epoch

time_point::operator+=time_point::operator-=

time_point::operator++time_point::operator-- (C++20)(C++20)

time_point::min

time_point::max

Функции, не являющиеся элементами

operator+operator-

operator==operator!=operator<operator<=operator>operator>=operator<=> (до C++20)(C++20)

time_point_cast

floor (C++17)

ceil (C++17)

round (C++17)

Вспомогательные классы

common_type

hash<std::chrono::time_point> (C++26)

 

<tbody> </tbody>

Определено в заголовочном файле <chrono>
template <class ToDuration, class Clock, class Duration> constexpr std::chrono::time_point<Clock, ToDuration> round(const std::chrono::time_point<Clock, Duration>& tp);		(начиная с C++17)

Возвращает ближайший момент времени к tp, представленный в ToDuration, с округлением в промежуточных случаях.

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

Параметры

tp

—

момент времени для округления до ближайшего

Возвращаемое значение

tp округлённое до ближайшего момента времени с использованием длительности типа 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 Clock, class FromDuration, class = std::enable_if_t<detail::is_duration_v<To> && !std::chrono::treat_as_floating_point_v<typename To::rep>>> constexpr std::chrono::time_point<Clock, To> round( const std::chrono::time_point<Clock, FromDuration>& tp) { return std::chrono::time_point<Clock, To>{ std::chrono::round<To>(tp.time_since_epoch())}; }

Пример

Запустить этот код

#include <iostream>
#include <chrono>
#include <string>

template <typename TimePoint>
std::string to_string(const TimePoint& time_point)
{
    return std::to_string(time_point.time_since_epoch().count());
}

int main()
{
    using namespace std::literals::chrono_literals;
    using Sec = std::chrono::seconds;

    std::cout << "Момент времени\t" "Приведение\t" "Floor\t" "Round\t" "Ceil\n";
    std::cout << "(мс)\t\t"     "(с)\t\t"  "(с)\t"   "(с)\t"   "(с)\n";
    for (const auto value_ms: {5432ms, 5678ms}) {
        std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds>
            time_point_ms(value_ms);

        std::cout
            << to_string(time_point_ms) << "\t\t"
            << to_string(std::chrono::time_point_cast<Sec>(time_point_ms)) << '\t'
            << to_string(std::chrono::floor          <Sec>(time_point_ms)) << '\t'
            << to_string(std::chrono::round          <Sec>(time_point_ms)) << '\t'
            << to_string(std::chrono::ceil           <Sec>(time_point_ms)) << '\n';
    }
}

Вывод:

Момент времени	Приведение	Floor	Round	Ceil
(мс)		(с)		(с)	(с)	(с)
5432		5		5	5	6
5678		5		5	6	6

Смотрите также

time_point_cast (C++11)	преобразует момент времени в другой момент времени на тех же часах с другой длительностью (шаблон функции)
ceil(std::chrono::time_point) (C++17)	преобразует time_point в другой, округляя в большую сторону (шаблон функции)
floor(std::chrono::time_point) (C++17)	преобразует time_point в другой, округляя в меньшую сторону (шаблон функции)
round(std::chrono::duration) (C++17)	преобразует duration в другой, округляя до ближайшего, или до чётного в промежуточных случаях (шаблон функции)
roundroundfroundllroundlroundflroundlllroundllroundfllroundl (C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)(C++11)	ближайшее целое число, округление от нуля в промежуточных случаях (функция)