Partilhar via


timespec_get, _timespec32_get, _timespec64_get

Define o intervalo apontado pelo primeiro argumento para a hora do calendário atual, com base na base de tempo especificada.

Sintaxe

int timespec_get( // See note in remarks section about linkage
    struct timespec* const time_spec,
    int const base
);
int _timespec32_get(
    struct _timespec32* const time_spec,
    int const base
);
int _timespec64_get(
    struct _timespec64* const time_spec,
    int const base
);

Parâmetros

time_spec
Ponteiro para uma estrutura que é definida para o tempo em segundos e nanossegundos desde o início da época.

base
Um valor específico de implementação diferente de zero que especifica a base de tempo.

Valor de retorno

O valor de base se bem-sucedido, caso contrário, ele retorna zero.

Observações

As timespec_get funções definem a hora atual na estrutura apontada time_spec pelo argumento. Todas as versões deste struct têm dois membros, tv_sec e tv_nsec. O tv_sec valor é definido para o número inteiro de segundos e tv_nsec para o número integral de nanossegundos, arredondado para a resolução do relógio do sistema, desde o início da época especificada por base.

Específico da Microsoft

Estas funções suportam apenas TIME_UTC como o base valor. TIME_UTC define o time_spec valor para o número de segundos e nanossegundos desde o início da época, meia-noite, 1 de janeiro de 1970, Tempo Universal Coordenado (UTC). Em um _timespec32, tv_sec é um __time32_t valor. Em um _timespec64, tv_sec é um __time64_t valor. Em um timespec, tv_sec é um time_t tipo, que tem 32 bits ou 64 bits de comprimento, dependendo se o _USE_32BIT_TIME_T de macro do pré-processador está definido. A timespec_get função é uma função embutida que chama _timespec32_get se _USE_32BIT_TIME_T é definida, caso contrário, chama _timespec64_get.

Fim Específico da Microsoft

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Observação

Quando você usa o Windows SDK versão 10.0.26100.6901 e Visual Studio 2026 ou posterior juntos, timespec_get não é mais static inline (ligação interna). Em vez disso, é inline (ligação externa).
Para retornar ao comportamento anterior, #define _STATIC_INLINE_UCRT_FUNCTIONS=1 antes de incluir quaisquer cabeçalhos CRT. Por padrão, _STATIC_INLINE_UCRT_FUNCTIONS é definido como 0.
Essa alteração aumenta a conformidade do UCRT com o padrão C++ e melhora a compatibilidade com módulos C++.

Requerimentos

Rotina Cabeçalho obrigatório
timespec_get, _timespec32_get, _timespec64_get C: <time.h>, C++: <ctime> ou <time.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Consulte também

Gestão do tempo
asctime, _wasctime
asctime_s, _wasctime_s
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
gmtime_s, _gmtime32_s, _gmtime64_s
localtime, _localtime32, _localtime64
localtime_s, _localtime32_s, _localtime64_s
time, _time32, _time64
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64