<chrono>

Inclua o cabeçalho padrão <chrono> para definir classes e funções que representam e manipulam durações de tempo e instantes de tempo.

Começando no Visual Studio 2015, a implementação de steady_clock mudou para atender aos requisitos de estabilidade e monotonicidade do C++ Padrão:

• steady_clock agora é baseado em QueryPerformanceCounter()
• high_resolution_clock agora é um typedef para steady_clock na implementação do Microsoft C++, steady_clock::time_point agora é um typedef para chrono::time_point<steady_clock>. No entanto, isso não é necessariamente o caso para outras implementações.

Requisitos

Cabeçalho: <chrono>

As legislaturas regionais ocasionalmente fazem alterações nos fusos horários, e um órgão internacional de padrões especifica quando novos segundos bissextos devem ser contabilizados. Um banco de dados dessas alterações foi adicionado ao Windows 10. Especificamente:

Recurso	Versão do cliente	Versão do servidor
Atualizações de banco de dados de segundos bissextos	Windows 10 versão 1809 ou posterior	Windows Server 2019 ou posterior
Suporte a fuso horário	Windows 10 versão 1903/19H1 ou posterior	Windows Server 2022 ou posterior

Usar as instalações de fuso horário em versões mais antigas do Windows resulta em um erro de runtime.

Namespace: std

Tipos calendrical

Nome	Descrição
Struct common_type	Descreve especializações do modelo de classe common_type para instanciações de duration e time_point.
day classe	Um dia do mês. Por exemplo, o 25º dia do mês.
duration classe	Um intervalo de tempo.
Struct duration_values	Fornece valores específicos para o parâmetro de modelo durationRep.
hh_mm_ss classe	Divide um duration em horas:minutos:segundos.
last_spec	Usado para indicar o último item em um mês, como o último dia da semana de um mês (a última terça-feira de fevereiro de 2020) ou o último dia de um mês (o último dia de abril de 2019).
leap_second classe	Uma data e um valor para um segundo bissexto inserido.
Struct leap_second_info	Os dados retornados por get_leap_second_info.
month classe	Um mês de um ano. Por exemplo, julho.
month_day classe	Um dia específico de um mês específico. Por exemplo, 30 de julho.
month_day_last classe	O último dia de um mês.
month_weekday classe	O nº dia útil de um mês específico.
month_weekday_last classe	O nº dia útil de um mês específico.
time_point classe	Um momento específico.
weekday classe	Um dia da semana.
weekday_last classe	O último dia da semana de um mês.
weekday_indexed classe	Combina um dia da semana com um índice que representa o dia útil do mês.
year classe	Um ano no calendário gregoriano.
year_month classe	Um ano e um mês. O dia não é especificado.
year_month_day classe	Um ano, mês e dia.
year_month_day_last classe	O último dia de um mês e um ano específicos.
year_month_weekday classe	Um ano, mês e nº dia útil do mês específicos.
year_month_weekday_last classe	Um ano, mês e último dia útil do mês específicos.

Relógios

Nome	Descrição
file_clock classe	Um alias para o relógio usado para std::filesystem::file_time_type, que é usado para expressar carimbos de data/hora de arquivo.
gps_clock classe	Um relógio que mantém o horário de GPS. Mede o tempo a partir do primeiro domingo de janeiro de 1980 às 00:00:00 UTC.
Struct high_resolution_clock	Um relógio com um período de tique de um nanossegundo.
Struct local_t	Um pseudorrelógio usado como um argumento para o modelo time_point para indicar que o time_point representa a hora local.
Struct steady_clock	Um relógio steady. Esse relógio é preferencial para medir intervalos de tempo.
Struct system_clock	Um relógio baseado no relógio de tempo real do sistema.
tai_clock classe	Mede a TAI (Hora Atômica Internacional) a partir de quinta-feira, 1º de janeiro de 1958 às 00:00:00. O relógio não contabiliza segundos intercalares.
utc_clock classe	Mede o tempo desde 00:00:00 UTC na quinta-feira, 1º de janeiro de 1970. Este relógio contabiliza segundos bissextos e é o padrão de tempo usado em todo o mundo.

Fusos horários

Nome	Descrição
choose	Uma enumeração que especifica como resolver a conversão ambígua de um local_time em um sys_time.
local_info	Fornece uma interface de baixo nível para informações de fuso horário sobre o resultado da conversão de um local_time em um sys_time.
sys_info	Fornece uma interface de baixo nível para informações de fuso horário sobre o resultado da conversão de um sys_time em um local_time.
time_zone classe	Todas as transições de fuso horário para uma área geográfica específica.
time_zone_link classe	Um nome alternativo para um time_zone.
Struct tzdb	Representa uma cópia do banco de dados de fuso horário.
tzdb_list classe	Uma lista singleton de bancos de dados de fuso horário.
zoned_time classe	Um emparelhamento de um time_zone e um time_point com uma precisão especificada.
Struct zoned_traits	Usado para associar um fuso horário padrão diferente a um zoned_time, e, opcionalmente, mapear um nome personalizado a esse fuso horário padrão.

Exceções

Nome	Descrição
ambiguous_local_time	Erro gerado quando um local_time é convertido em um sys_time e o resultado é ambíguo.
nonexistent_local_time	Erro gerado quando um local_time é convertido em um sys_time e o resultado é uma hora que não existe.

Funções

Nome	Descrição
ceil(duration)	Retorna o ceil de um objeto duration como um tipo especificado.
ceil(time_point)	Retorna o ceil de um objeto time_point como um tipo especificado.
clock_cast	Converte um time_point de um relógio para um time_point equivalente de outro relógio.
duration_cast	Converte um objeto duration em um tipo especificado.
floor(duration)	Retorna o floor de um objeto duration como um tipo especificado.
floor(time_point)	Retorna o floor de um objeto time_point como um tipo especificado.
from_stream()	Analise o fluxo de entrada em um dos tipos de tempo ou intervalo de std::chrono, como day, month, weekday, year e assim por diante, usando o formato especificado.
get_leap_second_info	Obtém um struct leap_second_info.
is_am	Se um objeto hours é ou não AM.
is_pm	Se um objeto hours é ou não PM.
locate_zone	Obtém um fuso horário especificado.
make12	Retorna um hours em formato de 12 horas.
make24	Retorna um hours em formato de 24 horas.
round(duration)	Retorna um objeto duration arredondado como um tipo especificado.
round(time_point)	Retorna um objeto time_point arredondado como um tipo especificado.
time_point_cast	Converte um objeto time_point em um tipo especificado.

Fuso horário relacionado

Nome	Descrição
current_zone	Obtém o fuso horário atual.
get_tzdb	Obtém a primeira entrada de banco de dados de fuso horário.
get_tzdb_list	Obtém a lista de entradas de banco de dados de fuso horário.
reload_tzdb	Obtém uma entrada de banco de dados de fuso horário atualizada.
remote_version	Verifica se há uma entrada de banco de dados de fuso horário atualizada.

Operadores

Nome	Descrição
operator-	Subtrair ou negar vários objetos <chrono>.
operator!=	Operador de desigualdade usado com diversos objetos <chrono>.
operator modulo	Operador para operações de módulo em objetos duration.
operator*	Operador de multiplicação para objetos duration.
operator/	Operador de divisão para objetos duration.
operator/	Fornece sintaxe para criar datas de calendário.
operator+	Adicione a vários objetos <chrono>.
operator<	Determina se vários objetos <chrono> são menores que outro.
operator<=	Determina se vários objetos <chrono> são menos ou iguais a outro.
operator==	Determina se vários objetos <chrono> são iguais uns aos outros.
operator>	Determina se vários objetos <chrono> são maiores que outro.
operator>=	Determina se vários objetos <chrono> são maiores ou iguais a outro.

Typedefs

Para obter mais informações sobre tipos de índice usados nos typedefs a seguir, confira <ratio>.

Tipos duration de conveniência

Nome	Descrição
typedef duration<long long, nano> nanoseconds;	Sinônimo de um tipo duration que tem um período de tique de um bilionésimo (1/1.000.000.000) de segundo.
typedef duration<long long, micro> microseconds;	Sinônimo de um tipo duration que tem um período de tique de um milionésimo (1/1.000.000) de segundo.
typedef duration<long long, milli> milliseconds;	Sinônimo de um tipo duration que tem um período de tique de um milésimo (1/1.000) de segundo.
typedef duration<long long> seconds;	Sinônimo de um tipo duration que tem um período de tique de um segundo.
typedef duration<int, ratio<60>> minutes;	Sinônimo de um tipo duration que tem um período de tique de um minuto.
typedef duration<int, ratio<3600>> hours;	Sinônimo de um tipo duration que tem um período de tique de uma hora.

Tipos time_point de conveniência

Nome	Descrição
file_time	Um sinônimo de time_point<file_clock, Duration>. Representa um time_point para um file_clock. Você especifica o Duration, por exemplo, file_time<seconds> ft;.
gps_seconds	Um sinônimo para gps_time<seconds>; Uma contagem de segundos, representada por um time_point associado a um gps_clock.
gps_time	Um sinônimo de time_point<gps_clock, Duration>. Representa um time_point para um gps_clock. Você especifica o Duration, por exemplo, gps_time<milliseconds> gps;.
local_days	Um sinônimo de local_time<days>. Uma contagem de dias, representada por um time_point que não está associado a nenhum fuso horário.
local_seconds	Um sinônimo de local_time<seconds>.
local_time	Um sinônimo de time_point<local_t, Duration>. Representa um time_point para uma hora local que ainda não está associada a um fuso horário. Você especifica o Duration, por exemplo, local_time<seconds> lt;. A local_time é uma hora local em algum lugar. Ela não é a hora local atual do relógio do computador. Somente quando ao emparelhar um local_time com um time_zone você obtém um ponto no tempo que pode ser convertido em hora UTC ou na hora em um fuso horário específico.
sys_days	Um sinônimo de sys_time<days>. Uma contagem de dias desde a época de system_clock, representada por um time_point associado a um system_clock.
sys_seconds	Um sinônimo de sys_time<seconds>. Uma contagem de segundos não bissextos desde a época de system_clock (1º de janeiro de 1970 00:00:00 UTC), representada por um time_point associado a um system_clock.
sys_time	Um sinônimo de time_point<system_clock, Duration>. Você especifica o Duration, por exemplo, sys_time<seconds> st;. Representa um time_point retornado de system_clock::now(). Ele representa o horário do Unix, que se aproxima bastante da hora UTC.
tai_seconds	Um sinônimo de tai_time<seconds>. Uma contagem de segundos, representada por um time_point associado a um tai_clock.
tai_time	Um sinônimo de time_point<tai_clock, Duration>. Você fornece o Duration, por exemplo, tai_time<seconds> tt;. Representa um time_point para um tai_clock.
utc_seconds	Um sinônimo de utc_time<seconds>;
utc_time	Um sinônimo de time_point<utc_clock, Duration>. Você fornece o Duration, por exemplo, utc_time<seconds> ut;. Representa um time_point para um utc_clock.

Características de tipo

Nome	Descrição
clock_time_conversion	Uma característica que especifica como converter um time_point de um relógio para outro.
is_clock	Verifique se um tipo é um relógio.
treat_as_floating_point	Verifique se um duration pode ser convertido em outro duration que tenha um período de tique diferente.

Literais

(C++11) O cabeçalho <chrono> define os seguintes literais definidos pelo usuário que você pode usar para maior conveniência, segurança de tipos e facilidade de manutenção do seu código. Esses literais são definidos no namespace embutido literals::chrono_literals e estão no escopo quando std::chrono está no escopo.

Declaração	Descrição
hours operator "" h(unsigned long long Val)	Especifica horas como um valor integral.
duration<double, ratio<3600>> operator "" h(long double Val)	Especifica horas como um valor de ponto flutuante.
minutes (operator "" min)(unsigned long long Val)	Especifica minutos como um valor integral.
duration<double, ratio<60>> (operator "" min)( long double Val)	Especifica minutos como um valor de ponto flutuante.
seconds operator "" s(unsigned long long Val)	Especifica minutos como um valor integral.
duration<double> operator "" s(long double Val)	Especifica segundos como um valor de ponto flutuante.
milliseconds operator "" ms(unsigned long long Val)	Especifica milissegundos como um valor integral.
duration<double, milli> operator "" ms(long double Val)	Especifica milissegundos como um valor de ponto flutuante.
microseconds operator "" us(unsigned long long Val)	Especifica microssegundos como um valor integral.
duration<double, micro> operator "" us(long double Val)	Especifica microssegundos como um valor de ponto flutuante.
nanoseconds operator "" ns(unsigned long long Val)	Especifica nanossegundos como um valor integral.
duration<double, nano> operator "" ns(long double Val)	Especifica nanossegundos como um valor de ponto flutuante.

Os seguintes exemplos mostram como usar os literais <chrono>:

constexpr auto day = 24h;
constexpr auto week = 24h* 7;
constexpr auto my_duration_unit = 108ms;

Confira também

Referência de Arquivos de Cabeçalho