Partager via


asctime, _wasctime

convertissez une structure de temps d' tm à une chaîne de caractères.plus les versions sécurisées de ces fonctions sont disponibles ; consultez l' asctime_s, _wasctime_s.

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

Paramètres

  • timeptr
    structure d'heure/date.

Valeur de retour

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

Notes

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

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

membre de timeptr

Valeur

tm_hour

Heures depuis minuit (0-23)

tm_isdst

Positif si l'heure d'été est activé ; 0 si l'heure d'été n'est pas appliqué ; négatif si l'état d'heure d'été est inconnu.La bibliothèque Runtime C utilise des règles des états-unis pour implémenter le calcul de l'heure d' (DST)été.

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 la 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)

La chaîne de caractères convertie est également ajustée en fonction de les paramètres de fuseau horaire local.Pour plus d'informations sur la configuration de l'heure locale, consultez temps, _ftime, et les fonctions de localtime et la fonction de _tzset pour plus d'informations sur la définition de l'environnement et les variables globales de fuseau horaire.

Le résultat de chaîne produit par asctime 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 et le caractère NULL occupent les deux dernières positions de la chaîne.asctime utilise une mémoire tampon unique et statique allouée pour stocker la chaîne de retour.Chaque appel de cette fonction détruit le résultat de l'appel précédent.

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

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 des paramètres.Si est autorisé à l'exécution de se poursuivre, la fonction retourne NULL et définit errno à EINVAL.

mappage de routines de texte générique

routine de TCHAR.H

_MBCS & de _UNICODE non défini

_MBCS défini

_UNICODE défini

_tasctime

asctime

asctime

_wasctime

Configuration requise

routine

en-tête requis

asctime

<time.h>

_wasctime

<time.h> ou <wchar.h>

Exemple

Ce programme place l'heure système dans long aclockentier, la traduction dans la structure newtime puis le convertit au format de chaîne pour la sortie, à l'aide de la fonction d' 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
}
  

Équivalent .NET Framework

Voir aussi

Référence

Gestion de la durée

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

_ftime, _ftime32, _ftime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

time, _time32, _time64

_tzset

asctime_s, _wasctime_s