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 , timezone
et _tzname
.
Routines de temps
Fonction | Utiliser |
---|---|
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 , _wctime , , _wctime64 _ctime_s _wctime32_s _wctime_s _ctime64_s _ctime32_s _wctime32 _ctime64 _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 , gmtime_s _gmtime64 , , _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 , localtime_s _localtime64 , , _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 , _wutime _utime64 , , _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_t
32 bits. Pour plus d’informations, consultez les types et commentaires Standard dans la documentation pour les fonctions de temps individuelles.