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 time
fonctions_ftime
localtime
. 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 aclock
long, 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour