Gestion du temps

 

Date de publication : novembre 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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 n’est pas défini, la bibliothèque runtime 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, consultez _tzset et _daylight, timezone et _tzname.

Routines de temps

FonctionUtilisationÉquivalent .NET Framework
asctime, _wasctime, asctime_s, _wasctime_sConvertit 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.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
horlogeRenvoie le temps horloge écoulé pour le processus.Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_sConvertit 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.System::DateTime::GetDateTimeFormats, System::DateTime::ToString, System::DateTime::ToLongTimeString, System::DateTime::ToShortTimeString
difftime, _difftime32, _difftime64Calcule la différence entre deux heures.System::DateTime::Subtract
_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_sStocke l’heure système actuelle dans une variable de type struct _timeb ou de type struct``__timeb64. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.System::DateTime::Now
_futime, _futime32, _futime64Définit l’heure de modification du fichier ouvert.System::IO::File::SetLastAccessTime, System::IO::File::SetLastWriteTime, System::IO::File::SetCreationTime
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_sConvertit l’heure du type time_t en struct tm ou du type __time64_t en struct tm.Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.System::DateTime::UtcNow, System::DateTime::ToUniversalTime
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_sConvertit 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.System::DateTime::ToLocalTime
_mkgmtime, _mkgmtime32, _mkgmtime64Convertit une heure en valeur de calendrier au format GMT (heure de Greenwich).System::DateTime::ToUniversalTime
mktime, _mktime32, _mktime64Convertit une heure en valeur de calendrier.System::DateTime::DateTime
_strdate, _wstrdate, _strdate_s, _wstrdate_sRenvoie la date système actuelle sous forme de chaîne. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
strftime, wcsftime, _strftime_l, _wcsftime_lMet en forme la chaîne date/heure pour une utilisation internationale.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
_strtime, _wstrtime, _strtime_s, _wstrtime_sRenvoie l’heure système actuelle sous forme de chaîne. Les versions de ces fonctions avec le suffixe _s sont plus sécurisées.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
time, _time32, _time64Obtient l’heure système actuelle en type time_t, __time32_t ou en type __time64_t.Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_tzsetDéfinit les variables d’heure externes à partir de la variable d’environnement d’heure TZ.Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64Dé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.Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.
System_CAPS_ICON_note.jpg 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.

System_CAPS_ICON_note.jpg Remarque

Dans les versions de Visual C++ et de Microsoft C/C++ antérieures à Visual C++ 2005, time_t était une valeur long int (32 bits) et ne pouvait donc pas être utilisé pour les dates postérieures au 19 janvier 2038 à 3:14:07 (heure 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 la rubrique Types standard et les commentaires dans la documentation sur les fonctions time.

Routines runtime par catégorie

Afficher: