Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

asctime_s, _wasctime_s

Convertit un structure temporelle tm en une chaîne de caractères. Ces fonctions sont des versions de asctime, _wasctime avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

errno_t asctime_s( 
   char* buffer,
   size_t numberOfElements,
   const struct tm *_tm 
);
errno_t _wasctime_s( 
   wchar_t* buffer,
   size_t numberOfElements
   const struct tm *_tm 
);
template <size_t size>
errno_t asctime_s( 
   char (&buffer)[size],
   const struct tm *_tm 
); // C++ only
template <size_t size>
errno_t _wasctime_s( 
   wchar_t (&buffer)[size],
   const struct tm *_tm 
); // C++ only

buffer

[out] Un pointeur vers une mémoire tampon pour stocker le résultat de chaîne de caractères. Cette fonction prend un pointeur vers l'emplacement d'une mémoire valide avec une taille spécifiée par numberOfElements.

numberOfElements

[in] la taille de la mémoire tampon utilisée pour stocker le résultat.

_tm

[in] Structure Temps/Date. Cette fonction prend un pointeur vers un objet valide structtm.

Zéro en cas de réussite. S'il y a un échec, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à continuer, la valeur de retour est un code d'erreur. Les codes d'erreur sont définis dans ERRNO.H. Pour plus d'informations, consultez errno, constantes. Les codes d'erreur réels retournés pour chaque condition d'erreur sont présentés dans le tableau ci-dessous.

Conditions d'erreur

buffer

numberOfElements

tm

Return

Valeur dans buffer

NULL

ANY

ANY

EINVAL

Non modifié

NonNULL (pointe vers la mémoire valide)

0

ANY

EINVAL

Non modifié

Non NULL

0< size < 26

ANY

EINVAL

Chaîne vide

Non NULL

>= 26

NULL

EINVAL

Chaîne vide

Non NULL

>= 26

Structure de temps non valide ou valeurs hors limite pour les composants du temps

EINVAL

Chaîne vide

Remarque Remarque

Les conditions d'erreur pour wasctime_s sont similaires à asctime_s sauf que la limite est mesurée en mots.

La fonction asctime convertit une heure enregistrée comme structure en une chaîne de caractères. La valeur _tm est généralement obtenue à partir d'un appel à gmtime ou à localtime. Les deux fonctions peuvent être utilisées pour remplir une structure tm, comme défini dans TIME.H.

membre de timeptr

Valeur

tm_hour

les heures depuis minuit (0-23)

tm_isdst

Positive si l'heure d'été est appliquée ; 0 si l'heure d'été n'est pas appliquée ; négatif si l'état d'heure d'été est inconnu. La bibliothèque Runtime C suppose l'utilisation des règles des États-Unis pour implémenter le calcul de l'heure d'été (DST).

tm_mday

Le jour du mois (1-31)

tm_min

Les minutes après les heure (0-59)

tm_mon

Le mois (0-11 ; Janvier = 0)

tm_sec

Les secondes après les minutes (0-59)

tm_wday

Le jour de la semaine (0-6 ; Dimanche = 0)

tm_yday

Le jour de l'année (0-365 ; 1er janvier = 0)

tm_year

L'année (année en cours moins 1900)

La chaîne de caractères convertie est également paramétrée conformément aux paramètres de fuseau horaire. Consultez time, _time32, _time64, _ftime, _ftime32, _ftime64, ainsi que les fonctions localtime_s, _localtime32_s, _localtime64_s pour plus d'informations sur la configuration de l'heure locale et la fonction _tzset pour plus d'informations sur la configuration de l'environnement et des variables globales du fuseau horaire.

Le résultat de chaîne généré par asctime_s contient exactement 26 caractères et se présente sous la forme Wed Jan 02 02:03:55 1980\n\0. Une horloge de 24 heures est utilisé. Tous les champs ont une largeur constante. Le nouveau caractère ligne et le caractère null occupent les deux dernières positions de la chaîne. La valeur passée comme deuxième paramètre doit être au moins aussi grande. Si elle est inférieure, un code d'erreur, EINVAL, est retourné.

_wasctime_s est une version à caractère élargi de asctime_s. _wasctime_s et asctime_s se comportent sinon de manière identique.

Mappage de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_MBCS défini

_UNICODE défini

_tasctime_s

asctime_s

asctime_s

_wasctime_s

En C++, l'utilisation de ces fonctions est simplifiée par des surcharges de modèle ; les surcharges peuvent également déduire la longueur de la mémoire tampon automatiquement, en éliminant le besoin de spécifier un argument de taille. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Routine

En-tête requis

asctime_s

<time.h>

_wasctime_s

<time.h> or <wchar.h>

Sécurité

Si le pointeur de mémoire tampon n'est pas NULL et le pointeur ne pointe pas vers une mémoire tampon valide, la fonction écrit par dessus, quoi qu'il y ait à l'emplacement. Cela peut également entraîner une violation d'accès.

Un dépassement de mémoire tampon peut se produire si l'argument de taille transmis est supérieur à la taille réelle de la mémoire tampon.

Ce programme place l'heure système dans l'entier long aclock, le traduit dans la structure newtime puis le convertit au format chaîne pour la sortie, à l'aide de la fonction asctime_s.

// crt_asctime_s.c
#include <time.h>
#include <stdio.h>

struct tm newtime;
__time32_t aclock;

int main( void )
{
   char buffer[32];
   errno_t errNum;
   _time32( &aclock );   // Get time in seconds.
   _localtime32_s( &newtime, &aclock );   // Convert time to struct tm form.

   // Print local time as a string.

   errNum = asctime_s(buffer, 32, &newtime);
   if (errNum)
   {
       printf("Error code: %d", (int)errNum);
       return 1;
   }
   printf( "Current date and time: %s", buffer );
   return 0;
}
Date et heure actuelle : Mercredi 14 mai 15:30:17 2003

  • DateTime.ToLongDateString

  • DateTime.ToLongTimeString

  • DateTime.ToShortDateString

  • DateTime.ToShortTimeString

  • DateTime.ToString

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft