ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Convertissent une valeur de temps en une chaîne et ajustent les paramètres de fuseau horaire local. Des versions plus sécurisées de ces fonctions sont disponibles ; voir , , _ctime64_s_ctime32_s, _wctime_s, , _wctime32_s, _wctime64_s.ctime_s

Syntaxe

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

Paramètres

sourceTime
Pointeur vers le temps stocké à convertir.

Valeur retournée

Pointeur désignant le résultat de chaîne de caractères. NULL est retourné lorsque :

• sourceTime représente une date antérieure au 1er janvier 1970 à minuit, UTC ;

• Vous utilisez _ctime32 ou _wctime32représente sourceTime une date après 23 :59 :59 :59 janvier 18, 2038, UTC.

• Vous utilisez _ctime64 ou _wctime64représente sourceTime une date après 23 :59 :59, le 31 décembre 3000, UTC.

ctime est une fonction inline qui prend la valeur _ctime64, tandis que time_t équivaut à __time64_t. Si vous devez forcer le compilateur à interpréter time_t comme ancien time_t32 bits, vous pouvez définir _USE_32BIT_TIME_T. Cette macro provoque ctime l’évaluation _ctime32. Nous vous déconseillons de l’utiliser, 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 ctime fonction convertit une valeur de temps stockée sous forme time_t de valeur en chaîne de caractères. La sourceTime valeur est généralement obtenue à partir d’un appel à time, qui retourne le nombre de secondes écoulées depuis minuit (00 :00 :00), le 1er janvier 1970, temps universel coordonné (UTC). La chaîne de valeur de retour contient exactement 26 caractères et présente la forme suivante :

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. Pour plus d’informations sur la configuration de l’heure locale, consultez les fonctions et les timefonctions_ftimelocaltime. Pour plus d’informations sur la définition de l’environnement de fuseau horaire et des variables globales, consultez la _tzset fonction.

Un appel à ctime modifie la mémoire tampon unique allouée de manière statique qu’utilisent les fonctions gmtime et localtime. Chaque appel à une de ces routines détruit le résultat de l’appel précédent. ctime partage une mémoire tampon statique avec la fonction asctime. Ainsi, 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 _ctime64 ; ils retournent un pointeur désignant une chaîne à caractères larges. Sinon, _ctime64, _wctime et _wctime64 se comportent de la même façon que ctime.

Ces fonctions valident leurs paramètres. S’il sourceTime s’agit d’un pointeur Null ou si la sourceTime valeur est négative, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, les fonctions retournent NULL et affectent à errno la valeur EINVAL.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

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

Spécifications

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 plus d’informations sur la compatibilité, consultez Compatibility.

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
}

The time is Wed Feb 13 16:04:43 2002

Voir aussi

Gestion des horaires
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