Classe utc_clock
Um relógio em UTC (Tempo Universal Coordenado), que às vezes é conhecido popularmente como GMT (Tempo Médio de Greenwich) ou horário Zulu. A hora local é ajustada com base no horário UTC dependendo do fuso horário.
Sintaxe
class utc_clock; // C++20
Comentários
Este relógio mede o tempo desde 00:00:00 UTC na quinta-feira, 1º de janeiro de 1970. Este relógio conta os segundos intercalares e é a base do horário civil em todo o mundo.
A taxa do tempo UTC baseia-se no TAI (Tempo Atômico Internacional), que usa relógios atômicos para acompanhar o tempo. No entanto, um segundo intercalar é adicionado ocasionalmente ao horário UTC para manter a diferença entre o UTC e o UT1 (tempo solar) em +- 0,9 segundo.
Há uma discrepância entre o tempo controlado pelos relógios atômicos e o tempo controlado acompanhando a rotação da Terra. Isso ocorre porque a velocidade de rotação da Terra é irregular, e em geral está desacelerando ao longo do tempo em cerca de um segundo a cada 1,5 anos (embora às vezes a velocidade de rotação da Terra aumente). Um ajuste de segundo intercalar mantém o horário acompanhado pelo UTC dentro de um segundo da duração média de um dia.
No momento da redação deste artigo, 27 segundos intercalares foram adicionados desde que a prática de inseri-los começou em 1972. O IERS (International Earth Rotation and Reference Systems Service) determina quando um segundo intercalar será adicionado. Adicionar um segundo intercalar é chamado de "inserção de segundo intercalar". Quando um segundo intercalar é inserido, o horário, conforme se aproxima da meia-noite, passa de 23 horas, 59 minutos e 59 segundos para 23 horas, 59 minutos e 60 segundos (o segundo intercalar inserido) e, em seguida, para 0 hora, 0 minuto e 0 segundo (meia-noite). Historicamente, os segundos intercalares foram adicionados em 30 de junho ou 31 de dezembro.
O horário UTC, por definição, começa 10 segundos atrás do TAI (tempo atômico). 10 segundos foram adicionados em 1972 ao horário TAI para acomodar os segundos intercalares acumulados até então. Dada a inserção de mais 27 segundos intercalares desde então, o horário UTC está 37 segundos atrás do horário TAI (relógio atômico).
Membros
| Nome | Descrição |
|---|---|
from_sys |
Estático. Converte uma sys_time em uma utc_time. |
now |
Estático. Retorna o tempo atual. |
to_sys |
Estático. Converte uma utc_time em uma sys_time. |
Não membros
| Nome | Descrição |
|---|---|
from_stream |
Analise um utc_time do fluxo fornecido usando o formato especificado. |
get_leap_second_info |
Obtém leap_second_info, que indica se a hora fornecida especifica uma hora em que um segundo intercalar foi inserido. Também inclui a soma de todos os segundos intercalares entre 1º de janeiro de 1970 e a duração especificada. |
operator<< |
Gerar um utc_time para o fluxo fornecido. |
Aliases de tipo de conveniência
| Nome | Descrição |
|---|---|
utc_clock::duration |
Na implementação da Microsoft, isso é sinônimo de duration<system_clock::rep, system_clock::period>. Isso representa uma duração de tempo medida em unidades de 100 nanossegundos. |
utc_clock::period |
A implementação da Microsoft o define como sinônimo de system_clock::period. Representa o tempo em segundos (100 nanossegundos) entre cada tique na duração. |
utc_clock::rep |
Um sinônimo do tipo (long long) usado para representar as unidades integrais no relógio utc_clock::duration. |
utc_clock::time_point |
Um sinônimo de time_point<utc_clock>. Usado para representar um time_point para esse relógio. |
Relacionado
| Nome | Descrição |
|---|---|
utc_seconds |
Um sinônimo de using utc_seconds = utc_time<seconds>; |
utc_time |
Um sinônimo de template<class Duration> using utc_time = time_point<utc_clock, Duration>;Representa um time_point para um utc_clock. Você especifica a duração. Definido em std::chrono |
Constantes públicas
| Nome | Descrição |
|---|---|
[utc_clock::is_steady constant](#is_steady_constant) |
Indica se o tipo de relógio é estável. Seu valor é false. |
Requisitos
Cabeçalho: <chrono> (desde C++20)
Namespace: std::chrono
Opção do compilador: /std:c++latest
from_sys
Método estático que converte um sys_time em um utc_time.
template<class Duration>
static utc_time<common_type_t<Duration, seconds>>
from_sys(const sys_time<Duration>& t);
Parâmetros
t
O sys_time a ser convertido.
Valor retornado
Um utc_time conjunto para o tempo que mais se aproxima do sys_time t. Se não houver um mapeamento direto, o time_point durante uma inserção de segundo intercalar e o último valor representável de sys_time antes da inserção do segundo intercalar serão retornados.
to_sys
Método estático que converte um utc_time em um sys_time.
template<class Duration>
static sys_time<common_type_t<Duration, seconds>>
to_sys(const utc_time<Duration>& t);
Parâmetros
t
O utc_time a ser convertido.
Valor de retorno
O sys_time definido como o ponto no tempo equivalente a t. Se não houver um mapeamento direto, ele será o último valor representável antes da inserção de um segundo intercalar no caso em que t representa um ponto no tempo em que um segundo intercalar foi inserido. Adicionar um segundo intercalar é chamado de "inserção de segundo intercalar". Quando um segundo intercalar é inserido, o horário, conforme se aproxima da meia-noite, passa de 23 horas, 59 minutos e 59 segundos para 23 horas, 59 minutos e 60 segundos (o segundo intercalar inserido) e, em seguida, para 0 hora, 0 minuto e 0 segundo (meia-noite). No passado, os segundos intercalares foram adicionados em 30 de junho ou 31 de dezembro.
is_steady
Valor estático que especifica se o tipo de relógio é estável. Na implementação da Microsoft, is_steady_constant é false. Como o utc_clock não é estável, não é possível usar esse relógio de maneira confiável para mediar o tempo antes de um evento, o tempo após um evento e subtraí-los para obter a duração do evento porque o relógio pode ser ajustado durante esse tempo.
static const bool is_steady = false;
now
Método estático que retorna a hora UTC atual. A hora retornada inclui segundos intercalares.
static time_point now() noexcept;
Valor de retorno
Um objeto time_point que representa a hora atual. O ponto de tempo retornado é efetivamente from_sys(system_clock::now()).
Confira também
<chrono>
file_clock class
gps_clock class
high_resolution_clock
Structlocal_t
Structsteady_clock
Structsystem_clock
tai_clock classe
Referência de Arquivos de Cabeçalho