Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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