asctime, _wasctime

Article
06/09/2015

Convertit une structure d'heure tm en une chaîne de caractères. Des versions plus sécurisées de ces fonctions sont disponibles ; consultez asctime_s, _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

Paramètres

timeptr
Structure Heure/date.

Valeur de retour

asctime retourne un pointeur vers une chaîne de caractères ; _wasctime retourne un pointeur vers le résultat de chaîne de caractères larges. Il n'y a pas de valeur de retour d'erreur.

Notes

Des versions plus sécurisées de ces fonctions sont disponibles ; consultez asctime_s, _wasctime_s.

La fonction asctime convertit une heure enregistrée comme structure en une chaîne de caractères. La valeur timeptr est généralement obtenue à partir d'un appel à gmtime ou à localtime, les deux retournent un pointeur vers une structure tm, définie dans TIME.H.

membre de timeptr	Valeur
tm_hour	les heures depuis minuit (0-23)
tm_isdst	Positive si l'heure d'été est appliquée ; 0 si l'heure d'été n'est pas appliquée ; négatif si l'état d'heure d'été est inconnu. La bibliothèque Runtime C suppose l'utilisation des règles des États-Unis pour implémenter le calcul de l'heure d'été (DST).
tm_mday	Le jour du mois (1-31)
tm_min	Les minutes après les heure (0-59)
tm_mon	Le mois (0-11 ; Janvier = 0)
tm_sec	Les secondes après les minutes (0-59)
tm_wday	Jour de la semaine (0-6; Dimanche = 0)
tm_yday	Le jour de l'année (0-365 ; 1er janvier = 0)
tm_year	L'année (année en cours moins 1900)

La chaîne de caractères convertie est également paramétrée conformément aux paramètres de fuseau horaire. Pour des informations sur la configuration de l'heure locale, consultez les fonctions time, _ftime, et localtime, et la fonction _tzset pour plus d'informations sur la définition de l'environnement des fuseaux horaires et des variables globales.

Le résultat de chaîne généré par asctime contient exactement 26 caractères et se présente sous la forme Wed Jan 02 02:03:55 1980\n\0. Une horloge de 24 heures est utilisé. Tous les champs ont une largeur constante. Le nouveau caractère ligne et le caractère null occupent les deux dernières positions de la chaîne. asctime utilise une mémoire tampon unique, statiquement allouée pour stocker la chaîne de retour. Chaque appel à la fonction détruit le résultat de l'appel précédent.

_wasctime est une version à caractère élargi de asctime. _wasctime et asctime se comportent sinon de manière identique.

Ces fonctions valident leurs paramètres. Si timeptr est un pointeur null, ou s'il contient des valeurs hors limites, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, la fonction retourne NULL et définit errno à la valeur EINVAL.

Mappage de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_MBCS défini	_UNICODE défini
_tasctime	asctime	asctime	_wasctime

Configuration requise

Routine	En-tête requis
asctime	<time.h>
_wasctime	<time.h> or <wchar.h>

Exemple

Ce programme place l'heure système dans l'entier long aclock, le traduit dans la structure newtime puis le convertit au format chaîne pour la sortie, à l'aide de la fonction asctime.

// crt_asctime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}