ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

 

Date de publication : novembre 2016

Pour la documentation la plus récente de Visual Studio 2017 RC, consultez Documentation RC de Visual Studio 2017.

Convertir une valeur d’heure en une chaîne et ajuster les paramètres de fuseau horaire local. Des versions plus sécurisées de ces fonctions sont disponibles. consultez ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime(   
   const time_t *timer   
);  
char *_ctime32(   
   const __time32_t *timer )  
;  
char *_ctime64(   
   const __time64_t *timer )  
;  
wchar_t *_wctime(   
   const time_t *timer   
);  
wchar_t *_wctime32(   
   const __time32_t *timer  
);  
wchar_t *_wctime64(   
   const __time64_t *timer   
);  

Paramètres

timer
Pointeur vers l’heure stockée.

Pointeur vers le résultat de chaîne de caractères.NULL est renvoyée si :

  • time représente une date antérieure au 1er janvier 1970 à minuit UTC.

  • Si vous utilisez _ctime32 ou _wctime32 et time représente une date postérieure à 23:59:59 18 janvier 2038, UTC.

  • Si vous utilisez _ctime64 ou _wctime64 et time représente une date postérieure à 23:59:59 le 31 décembre 3000, UTC.

ctime est une fonction inline qui prend la valeur _ctime64 et time_t équivaut à __time64_t. Si vous devez forcer le compilateur à interpréter time_t l’ancien 32-bit time_t, vous pouvez définir _USE_32BIT_TIME_T. Cette action provoquerait ctime pour prendre la valeur _ctime32. Cela est déconseillé, car votre application peut échouer après le 18 janvier 2038, et il n’est pas autorisée sur les plateformes 64 bits.

Le ctime fonction convertit une valeur d’heure stockée en tant qu’un time_t valeur dans une chaîne de caractères. Le timer valeur est généralement obtenue à partir d’un appel à temps, qui retourne le nombre de secondes écoulé depuis minuit (00 : 00:00), le 1er janvier 1970, temps universel (UTC). La chaîne de valeur de retour contient exactement 26 caractères et présente sous la forme :

Wed Jan 02 02:03:55 1980\n\0  

Une horloge de 24 heures est utilisée. Tous les champs ont une largeur constante. Le caractère de saut de ligne ('\n') et le caractère null ('\0') occupent les deux dernières positions de la chaîne.

La chaîne de caractères convertie est également ajustée en fonction des paramètres de fuseau horaire local. Consultez le time, _ftime, et localtime fonctions pour plus d’informations sur la configuration de l’heure locale et la _tzset (fonction) pour plus d’informations sur la définition de l’environnement de fuseau horaire et des variables globales.

Un appel à ctime modifie le tampon alloué de manière statique unique utilisé par le gmtime et localtime fonctions. Chaque appel à une de ces routines détruit le résultat de l’appel précédent.ctime partage d’une mémoire tampon statique avec le asctime (fonction). Par conséquent, un appel à ctime détruit les résultats d’un appel précédent à asctime, localtime, ou gmtime.

_wctime et _wctime64 sont la version à caractères larges de ctime et _ctime64qui retourne un pointeur vers une chaîne à caractères larges. Dans le cas contraire, _ctime64, _wctime, et _wctime64 se comportent de la même manière que ctime.

Ces fonctions valident leurs paramètres. Si timer est un pointeur null, ou si la valeur est négative, ces fonctions appellent le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à se poursuivre, les fonctions retournent NULL et errno à EINVAL.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tctimectimectime_wctime
_tctime32_ctime32_ctime32_wctime32
_tctime64_ctime64_ctime64_wctime64
RoutineEn-tête requis
ctime<time.h>
_ctime32<time.h>
_ctime64<time.h>
_wctime< time.h > ou < wchar.h >
_wctime32< time.h > ou < wchar.h >
_wctime64< time.h > ou < wchar.h >

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

// crt_ctime64.c  
// compile with: /W3  
/* This program gets the current  
 * time in _time64_t form, then uses ctime to  
 * display the time in string form.  
 */  
  
#include <time.h>  
#include <stdio.h>  
  
int main( void )  
{  
   __time64_t ltime;  
  
   _time64( &ltime );  
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996  
   // Note: _ctime64 is deprecated; consider using _ctime64_s  
}  

Le temps est le 13 février mercredi 16:04:43 2002  

Gestion du temps
asctime, _wasctime
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64

Afficher: