_strtime, _wstrtime

Copient l’heure dans une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles ; voir _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 EINVALerrno sur si timestr elle était ou errnoNULLERANGE 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 Surcharges de modèles sécurisés.

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 routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tstrtime	_strtime	_strtime	_wstrtime

Spécifications

Routine	En-tête requis
_strtime	<time.h>
_wstrtime	<time.h> ou <wchar.h>

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, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset