timespec_get, _timespec32_get, _timespec64_get

Establece el intervalo al que apunta el primer argumento en la hora actual del calendario, basándose en la base de tiempo especificada.

Sintaxis

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
Puntero para una estructura que se establece en el tiempo en segundos y nanosegundos desde el inicio de la época.

base
Un valor específico de implementación distinta de cero que especifica la base de tiempo.

Valor devuelto

El valor de base si es correcto; de lo contrario, devuelve cero.

Comentarios

Las funciones timespec_get establecen la hora actual en la estructura a la que apunta el argumento time_spec . Todas las versiones de esta estructura tienen dos miembros, tv_sec y tv_nsec. El valor tv_sec se establece en el número entero de segundos y tv_nsec en el número integral de nanosegundos, redondeado a la resolución del reloj del sistema, desde el inicio de la época especificada por base.

Específicos de Microsoft

Estas funciones solo admiten TIME_UTC como el valor base . TIME_UTC establece el time_spec valor en el número de segundos y nanosegundos desde el inicio de la época, Medianoche, 1 de enero de 1970, Hora universal coordinada (UTC). En _timespec32, tv_sec es un valor __time32_t . En _timespec64, tv_sec es un valor __time64_t . En timespec, tv_sec es un tipo time_t , que tiene una longitud de 32 o 64 bits, en función de si se define la macro de preprocesador _USE_32BIT_TIME_T. La timespec_get función es una función insertada que llama a _timespec32_get si _USE_32BIT_TIME_T se define; de lo contrario, llama a _timespec64_get.

End Microsoft Specific

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
timespec_get, _timespec32_get, _timespec64_get	C: <time.h>, C++: <ctime> o <time.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Administración de tiempo
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