asctime, _wasctime

Article
03/26/2013

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
}