asctime, _wasctime

Convertissent une structure de temps tm en une chaîne de caractères. Des versions plus sécurisées de ces fonctions sont disponibles ; voir asctime_s, _wasctime_s.

Syntaxe

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

Paramètres

timeptr
Structure date/heure.

Valeur retournée

asctime retourne un pointeur désignant le résultat de chaîne de caractères ; _wasctime retourne un pointeur désignant le résultat de chaîne à caractères larges. Il n’existe aucune valeur de retour d’erreur.

Notes

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

La fonction asctime convertit une valeur de temps stockée en tant que structure en une chaîne de caractères. La timeptr valeur est généralement obtenue à partir d’un appel vers gmtime ou localtime, qui retourne tous deux un pointeur vers une tm structure, définie dans TIME.H.

Membretimeptr	Value
tm_hour	Heures depuis minuit (0-23)
tm_isdst	Positif si l’heure d’été est en vigueur ; 0 si l’heure d’été n’est pas en vigueur ; négatif si l’état de l’heure d’été est inconnu. La bibliothèque runtime C suppose que les règles de calcul de l’heure d’été sont celles des États-Unis.
tm_mday	Jour du mois (1 à 31)
tm_min	Minutes après l’heure (0-59)
tm_mon	Mois (0-11 ; Janvier = 0)
tm_sec	Secondes après minute (0-59)
tm_wday	Jour de la semaine (0-6 ; Dimanche = 0)
tm_yday	Jour de l’année (0-365 ; 1er janvier = 0)
tm_year	Année (année en cours moins 1900)

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.

Le résultat de chaîne généré par asctime contient exactement 26 caractères et présente la forme Wed Jan 2 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 et le caractère null occupent les deux dernières positions de la chaîne. asctime utilise une seule mémoire tampon allouée de manière statique pour contenir la chaîne de retour. Chaque appel à cette fonction détruit le résultat de l’appel précédent.

_wasctime est une version à caractères larges de asctime, et se comporte autrement de la même façon que asctime.

Ces fonctions valident leurs paramètres. S’il timeptr s’agit d’un pointeur Null ou s’il contient des valeurs hors plage, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l'exécution est autorisée à continuer, cette fonction retourne NULL et définit à errno à EINVAL.

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

Mappage de routine de texte générique

TCHAR.H Routine	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tasctime	asctime	asctime	_wasctime

Spécifications

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

Exemple

Ce programme place l’heure système dans l’entier aclocklong, la traduit en structure newtime, puis la convertit en forme de chaîne pour la sortie à l’aide de la asctime fonction.

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

Current date and time: Sun Feb  3 11:38:58 2002

Voir aussi

Gestion des horaires
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64
_tzset
asctime_s, _wasctime_s