std::chrono::duration

 

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::duration

Функции-элементы
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%=
Функции, не являющиеся элементами
operator+operator-operator*operator/operator% operator==operator!=operator<operator<=operator>operator>=operator<=> (до C++20)(C++20) operator<< (C++20)	duration_cast floor (C++17) ceil (C++17) round (C++17) abs (C++17) operator""h (C++14) operator""min (C++14) operator""s (C++14) operator""ms (C++14) operator""us (C++14) operator""ns (C++14) from_stream (C++20)
Вспомогательные классы
common_type treat_as_floating_point      duration_values	formatter<std::chrono::duration> (C++20) hash<std::chrono::duration> (C++26)

 

<tbody> </tbody>

Определено в заголовочном файле <chrono>
template< class Rep, class Period = std::ratio<1> > class duration;		(начиная с C++11)

Шаблонный класс std::chrono::duration представляет интервал времени.

Он состоит из счётчика тиков типа Rep и периода тика, где период тика представляет собой рациональное время компиляции fraction, представляющее время в секундах от одного тика к другому.

Единственные данные, хранящиеся в duration, это счётчик тиков типа Rep. Если Rep является числом с плавающей запятой, то duration может представлять доли тиков. Period включается как часть типа длительности и используется только при преобразовании между различными длительностями.

Типы элементы

Тип элементы	Определение
rep	Rep, арифметический тип, представляющий количество тиков
period	Period (до C++17)typename Period::type (начиная с C++17), std::ratio, представляющий период тика (т.е. количество долей секунды в тике)

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

(конструктор)	строит новый duration (public функция-элемент)
operator=	присваивает содержимое (public функция-элемент)
count	возвращает количество тиков (public функция-элемент)
zero [static]	возвращает специальное нулевое значение длительности (public static функция-элемент)
min [static]	возвращает специальное минимальное значение длительности (public static функция-элемент)
max [static]	возвращает специальное максимальное значение длительности (public static функция-элемент)
operator+operator-	реализует унарный + и унарный - (public функция-элемент)
operator++operator++(int)operator--operator--(int)	увеличивает или уменьшает количество тактов (public функция-элемент)
operator+=operator-=operator*=operator/=operator%=	реализует составное присваивание между двумя длительностями (public функция-элемент)

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

operator+operator-operator*operator/operator% (C++11)	реализует арифметические операции с duration в качестве аргументов (шаблон функции)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++11)(C++11)(удалено в C++20)(C++11)(C++11)(C++11)(C++11)(C++20)	сравнивает два duration (шаблон функции)
duration_cast (C++11)	преобразует duration в другой duration с другим интервалом тиков (шаблон функции)
floor(std::chrono::duration) (C++17)	преобразует duration в другой, округляя в меньшую сторону (шаблон функции)
ceil(std::chrono::duration) (C++17)	преобразует duration в другой, округляя в большую сторону (шаблон функции)
round(std::chrono::duration) (C++17)	преобразует duration в другой, округляя до ближайшего, или до чётного в промежуточных случаях (шаблон функции)
abs(std::chrono::duration) (C++17)	получает абсолютное значение duration (шаблон функции)
operator<< (C++20)	выполняет потоковый вывод в duration (шаблон функции)
from_stream (C++20)	разбирает duration из потока в соответствии с предоставленным форматом (шаблон функции)

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

Тип /* intXX */, используемый в таблице ниже, означает целочисленный тип со знаком длиной не менее XX бит.

Тип	Определение
std::chrono::nanoseconds	std::chrono::duration</* int64 */, std::nano>
std::chrono::microseconds	std::chrono::duration</* int55 */, std::micro>
std::chrono::milliseconds	std::chrono::duration</* int45 */, std::milli>
std::chrono::seconds	std::chrono::duration</* int35 */>
std::chrono::minutes	std::chrono::duration</* int29 */, std::ratio<60>>
std::chrono::hours	std::chrono::duration</* int23 */, std::ratio<3600>>
std::chrono::days (начиная с C++20)	std::chrono::duration</* int25 */, std::ratio<86400>>
std::chrono::weeks (начиная с C++20)	std::chrono::duration</* int22 */, std::ratio<604800>>
std::chrono::months (начиная с C++20)	std::chrono::duration</* int20 */, std::ratio<2629746>>
std::chrono::years (начиная с C++20)	std::chrono::duration</* int17 */, std::ratio<31556952>>

Примечание: каждый из предопределённых типов duration до hours охватывает диапазон не менее ±292 лет.

Каждый из предопределённых типов duration days, weeks, months и years охватывает диапазон не менее ±40000 лет. years равно 365.2425 days (средняя продолжительность григорианского года). months равен 30.436875 days (ровно 1/12 от years).

(начиная с C++20)

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

std::common_type<std::chrono::duration> (C++11)	специализация свойства std::common_type (специализация шаблона класса)
treat_as_floating_point (C++11)	указывает, что duration конвертируется в duration с другим периодом тика (шаблон класса)
duration_values (C++11)	строит нулевое, минимальное и максимальное значения счётчика тиков заданного типа (шаблон класса)
std::formatter<std::chrono::duration> (C++20)	поддержка форматирования для duration (специализация шаблона класса)
std::hash<std::chrono::duration> (C++26)	поддержка хэширования для std::chrono::duration (специализация шаблона класса)

Литералы

Определены в пространстве имён std::literals::chrono_literals
operator""h (C++14)	Литерал std::chrono::duration, представляющий часы (функция)
operator""min (C++14)	Литерал std::chrono::duration, представляющий минуты (функция)
operator""s (C++14)	Литерал std::chrono::duration, представляющий секунды (функция)
operator""ms (C++14)	Литерал std::chrono::duration, представляющий миллисекунды (функция)
operator""us (C++14)	Литерал std::chrono::duration, представляющий микросекунды (функция)
operator""ns (C++14)	Литерал std::chrono::duration, представляющий наносекунды (функция)

Примечание: буквенные суффиксы d и y относятся не к days и years, а к day и year соответственно.

(начиная с C++20)

Примечание

Фактический интервал времени (в секундах), удерживаемый объектом duration d, примерно равен d.count() * D::period::num / D::period::den, где D имеет тип chrono::duration<>, а d объект этого типа.

Макрос Тестирования функциональности	Значение	Стандарт	Функциональность
__cpp_lib_chrono_udls	201304L	(C++14)	Пользовательские литералы для типов времени

Пример

В этом примере показано, как определить несколько настраиваемых типов duration и выполнить преобразование между типами:

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

#include <iostream>
#include <chrono>
using namespace std::chrono_literals;

template<typename T1, typename T2>
using mul = std::ratio_multiply<T1, T2>;

int main()
{
    using microfortnights = std::chrono::duration<float,
        mul<mul<std::ratio<2>, std::chrono::weeks::period>, std::micro>>;
    using nanocenturies = std::chrono::duration<float,
        mul<mul<std::hecto, std::chrono::years::period>, std::nano>>;
    using fps_24 = std::chrono::duration<double, std::ratio<1,24>>;

    std::cout << "1 секунда это:\n";

    // преобразование целочисленного масштаба без потери точности: без приведения
    std::cout << std::chrono::milliseconds(1s).count() << " миллисекунд\n"
              << std::chrono::microseconds(1s).count() << " микросекунд\n"
              << std::chrono::nanoseconds(1s).count()  << " наносекунд\n";

    // преобразование целочисленного масштаба с потерей точности: требуется приведение
    std::cout << std::chrono::duration_cast<std::chrono::minutes>(1s).count()
              << " минут\n";

    // преобразование масштаба с плавающей запятой: без приведения
    std::cout << microfortnights(1s).count() << " microfortnights\n"
              << nanocenturies(1s).count() << " нановека\n"
              << fps_24(1s).count() << " кадра в 24fps\n";
}

Вывод:

1 секунда это:
1000 миллисекунд
1000000 микросекунд
1000000000 наносекунд
0 минут
0.82672 microfortnights
0.316887 нановека
24 кадра в 24fps