timespec_get, _timespec32_get, _timespec64_get

Affecte à l’intervalle indiqué par le premier argument l’heure de calendrier actuelle, en fonction de la base de temps spécifiée.

Syntaxe

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
);

Paramètres

time_spec
Pointeur vers un struct qui a pour valeur la durée, en secondes et nanosecondes, depuis le début de l’époque.

base
Valeur propre à l’implémentation différente de zéro qui spécifie la base de temps.

Valeur retournée

Valeur de base en cas de succès. Sinon, retourne la valeur zéro.

Notes

Les fonctions timespec_get définissent l’heure actuelle dans le struct vers lequel pointe l’argument time_spec . Toutes les versions de ce struct ont deux membres, tv_sec et tv_nsec. La valeur tv_sec correspond au nombre entier de secondes et tv_nsec au nombre entier de nanosecondes, arrondi à la résolution de l’horloge système, depuis le début de l’époque spécifiée par base.

Section spécifique à Microsoft

Ces fonctions prennent uniquement en charge TIME_UTC comme valeur base . TIME_UTC définit la valeur sur time_spec le nombre de secondes et de nanosecondes depuis le début de l’époque, Minuit, le 1er janvier 1970, temps universel coordonné (UTC). Dans un _timespec32, tv_sec est une valeur __time32_t . Dans un _timespec64, tv_sec est une valeur __time64_t . Dans un timespec, tv_sec est un type time_t de longueur 32 bits ou 64 bits selon que la macro de préprocesseur _USE_32BIT_TIME_T est définie ou non. La timespec_get fonction est une fonction inline qui appelle _timespec32_get si _USE_32BIT_TIME_T elle est définie ; sinon, elle appelle _timespec64_get.

End Microsoft Specific

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Routine	En-tête requis
timespec_get, _timespec32_get, _timespec64_get	C : <time.h>, C++ : <ctime> ou <time.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

Gestion des horaires
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