Gestion du temps

Utilisez ces fonctions pour obtenir l’heure actuelle, et la convertir, la régler et la stocker selon vos besoins. L’heure actuelle est l’heure système.

Les routines _ftime et localtime utilisent la variable d’environnement TZ . Si TZ ce n’est pas le cas, la bibliothèque d’exécution tente d’utiliser les informations de fuseau horaire spécifiées par le système d’exploitation. Si ces informations ne sont pas disponibles, ces fonctions utilisent la valeur par défaut PST8PDT. Pour plus d’informations sur TZ, voir _tzset; voir _daylightégalement , timezoneet _tzname.

Routines de temps

Fonction	Utilisation
asctime, _wasctime, asctime_s, _wasctime_s	Convertit une heure du type struct tm en chaîne de caractères. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
clock	Retourne le temps horloge écoulé pour le processus.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s	Convertit une heure du type time_t, __time32_t ou __time64_t en chaîne de caractères. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
difftime, _difftime32, _difftime64	Calcule la différence entre deux heures.
_ftime, , _ftime32_ftime_s_ftime64_ftime32_s, _ftime64_s	Stocke l’heure système actuelle dans une variable de type struct _timeb ou struct __timeb64 Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
_futime, _futime32, _futime64	Définit l’heure de modification du fichier ouvert.
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s	Convertir l’heure du type time_t vers struct tm ou du type __time64_t en struct tm. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s	Convertit une heure du type time_t en struct tm ou du type __time64_t en struct tm avec une correction locale. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
_mkgmtime, _mkgmtime32, _mkgmtime64	Convertit une heure en valeur de calendrier au format GMT (heure de Greenwich).
mktime, _mktime32, _mktime64	Convertit une heure en valeur de calendrier.
_strdate, _wstrdate, _strdate_s, _wstrdate_s	Renvoie la date système actuelle sous forme de chaîne. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
strftime, wcsftime, _strftime_l, _wcsftime_l	Met en forme la chaîne date/heure pour une utilisation internationale.
_strtime, _wstrtime, _strtime_s, _wstrtime_s	Renvoie l’heure système actuelle sous forme de chaîne. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.
time, _time32, _time64	Obtient l’heure système actuelle en type time_t, __time32_t ou en type __time64_t.
_tzset	Définit les variables d’heure externes à partir de la variable d’environnement d’heure TZ.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64	Définit l’heure de modification du fichier spécifié en fonction de l’heure actuelle ou de la valeur d’heure stockée dans la structure.

Remarque

Dans toutes les versions de Microsoft C/C++ à l’exception de Microsoft C/C++ version 7.0, et dans toutes les versions de Visual C++, l’heure actuelle renvoyée par la fonction time correspond au nombre de secondes écoulées depuis le 1er janvier 1970 à minuit. Dans Microsoft C/C++ version 7.0, l’heure actuelle renvoyée par time est le nombre de secondes écoulées depuis le 31 décembre 1899 à minuit.

Remarque

Dans les versions de Visual C++ et Microsoft C/C++ avant Visual Studio 2005, time_t était un long int (32 bits) et ne pouvait donc pas être utilisé pour les dates antérieures à 3 :14 :07 janvier 19, 2038, UTC. time_t est maintenant équivalent à __time64_t par défaut, mais définir _USE_32BIT_TIME_T change time_t en __time32_t et force de nombreuses fonctions time à appeler les versions qui prennent la valeur time_t32 bits. Pour plus d’informations, consultez les types et commentaires Standard dans la documentation pour les fonctions de temps individuelles.

Voir aussi

Routines du runtime C universel par catégorie