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. Consultez 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. Consultez 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.

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

Spécifications

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, _wctime_ctime64, , _wctime32_wctime64
_ftime, , _ftime32_ftime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
time, , _time32_time64
_tzset
asctime_s, _wasctime_s