ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Article
03/26/2013

Convertit une valeur d'heure en une chaîne et ajustez pour les paramètres de fuseau horaire local.plus les versions 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 temps stocké.

Valeur de retour

Un pointeur vers le résultat de chaînes.NULL sera retourné si :

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

ctime est une fonction inline qui correspond à _ctime64et time_téquivaut à __time64_t.Si vous devez forcer le compilateur à interpréter time_tcomme time_t32 bits ancien, vous pouvez définir _USE_32BIT_TIME_T.Cela entraînera l'évaluer ctimeà _ctime32.Cela n'est pas recommandé parce que votre application peut échouer après le 18 janvier 2038, et il n'est pas autorisé sur les plateformes 64 bits.

Notes

La fonction d' ctime convertit une valeur d'heure signalée comme valeur de time_t dans une chaîne de caractères.La valeur d' timer est généralement obtenue à partir d'un appel à temps, qui retourne le nombre de secondes écoulées depuis minuit (0h00 : 00), le 1er janvier 1970, coordinated universal time (UTC)).La chaîne de valeur de retour contient exactement 26 caractères et a la forme :

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

Une horloge au format 24 heures est utilisé.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 de les paramètres de fuseau horaire local.Voir time, _ftime, et les fonctions de localtime pour plus d'informations sur la configuration de l'heure locale et une fonctionnalité de _tzset pour plus d'informations sur la définition l'environnement et les variables globales de fuseau horaire.

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

_wctime et _wctime64 sont la version à caractère élargi d' ctime et _ctime64; retourner un pointeur vers la chaîne à caractères larges.Sinon, _ctime64, _wctime, et _wctime64 se comportent de manière identique à ctime.

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

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_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> ou <wchar.h>
_wctime32	<time.h> ou <wchar.h>
_wctime64	<time.h> ou <wchar.h>

Pour des informations de compatibilité supplémentaires, 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
}