timespec_get, _timespec32_get, _timespec64_get

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

Sintaxe

int timespec_get(
    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 um struct definido com a hora em segundos e nanossegundos desde o início da época.

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

Valor retornado

O valor base se tiver êxito; caso contrário, retornará zero.

Comentários

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

Seção específica da Microsoft

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

Fim da seção específica da Microsoft

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

Requisitos

Rotina	Cabeçalho necessário
timespec_get, _timespec32_get, _timespec64_get	C: <time.h>, C++: <ctime> or <time.h>

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

Confira também

Gerenciamento de 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