ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Article
06/09/2015

Convertis une information horaire en une chaîne de caractères et l'ajuste aux paramètres de fuseau horaire locaux. 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 le l'horaire stockée.

Valeur de retour

Un pointeur vers la chaîne de caractères résultante. NULL est renvoyée si :

time représente une date de minuit, le 1er janvier 1970, UTC.
Si vous utilisez _ctime32 ou _wctime32 et time représente une date après 3h14 7s : Le 19 janvier 2038.
Si vous utilisez _ctime64 ou _wctime64 et time représente une date après 23h59 59s : Le 31 décembre 3000, heure UTC.

ctime est une fonction inline qui prend _ctime64 , et time_t équivaut à __time64_t. Si vous devez forcer le compilateur à interpréter time_t en ancien 32 bit time_t, vous pouvez définir _USE_32BIT_TIME_T. Faire celà entrainera ctime à être évalué en _ctime32. Cela n'est pas recommandé car votre application peut échouer après le 18 janvier 2038, et elle n'est pas autorisée sur les plateformes 64 bits.

Notes

La fonction ctime convertit une valeur d'heure signalée comme valeur d'time_t en une chaîne de caractères. La valeur de timer est généralement obtenue à partir d'un appel à time, qui retourne le nombre de secondes s'est écoulée depuis minuit (0h00 : 00), le 1er janvier 1970, temps universel coordonné (UTC). La chaîne de valeur retournée contient exactement 26 caractères et se présente sous la forme suivante :

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

Une horloge de 24 heures est utilisé. Tous les champs ont une largeur constante. Le caractère nouvelle 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 paramétrée conformément aux paramètres de fuseau horaire. Consultez time, _ftime, et les fonctions localtime pour plus d'informations sur la configuration de l'heure locale et la fonction _tzset pour plus d'informations sur la définition de l'environnement des fuseaux horaires et des variables globales.

Un appel à ctime modifie la seule mémoire tampon statiquement allouée utilisée par les fonctions gmtime et localtime . Chaque appel à une de ces routines détruit le résultat de l'appel précédent. ctime partage un buffer statique avec la fonction asctime. Par conséquent, un appel à ctime détruit les résultats de tout appel précédent à asctime, à localtime, ou à gmtime.

_wctime et _wctime64 forment une version à caractères larges de ctime et _ctime64 ; retournent un pointeur vers une chaîne de caractères larges. Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

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

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_MBCS défini	_UNICODE défini
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Configuration requise

Routine	En-tête requis
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> or <wchar.h>
_wctime32	<time.h> or <wchar.h>
_wctime64	<time.h> or <wchar.h>

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

Exemple

// 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
}