_strtime, _wstrtime

Copient l’heure dans une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles. Consultez _strtime_s, _wstrtime_s.

Syntaxe

char *_strtime(
   char *timestr
);
wchar_t *_wstrtime(
   wchar_t *timestr
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

Paramètres

timestr
Chaîne d’heure.

Valeur retournée

Retourne un pointeur désignant la chaîne de caractères timestr obtenue.

Notes

La _strtime fonction copie l’heure locale actuelle dans la mémoire tampon pointée par timestr. L’heure est mise en forme sous la forme hh:mm:ssde deux hh chiffres qui représentent l’heure en notation de 24 heures. mm est deux chiffres pour les minutes passées l’heure, et ss deux chiffres pour les secondes. Par exemple, la chaîne 18:23:44 représente 23 minutes et 44 secondes après 6 heures. La mémoire tampon doit comporter au moins 9 octets de long.

_wstrtime est une version à caractères larges de _strtime ; l'argument et la valeur de retour de _wstrtime sont des chaînes à caractères larges. Ces fonctions se comportent sinon de façon identique. S’il timestr s’agit d’un NULL pointeur ou s’il timestr est mis en forme de manière incorrecte, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exception est autorisée à continuer, ces fonctions retournent une NULLvaleur définie EINVAL errno sur si timestr elle était ou errno NULL ERANGE définie sur si timestr elle est mise en forme incorrectement.

En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et sécurisés de ces fonctions. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

// crt_strtime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}

The current time is 14:21:44

Voir aussi

Gestion des horaires
asctime, _wasctime
ctime, , _ctime32, _wctime_ctime64, , _wctime32_wctime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
mktime, , _mktime32_mktime64
time, , _time32_time64
_tzset