_strtime, _wstrtime

Article
06/09/2015

Copiez l'heure vers une mémoire tampon. Des versions plus sécurisées de ces fonctions sont disponibles ; consultez _strtime_s, _wstrtime_s.

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 heure

Valeur de retour

Retourne un pointeur vers la chaîne de caractère modifiée timestr.

Notes

La fonction _strtime copie l'heure locale actuelle dans la mémoire tampon désignée par timestr*.* L'heure est mise sous la forme hh:mm:ss où hh sont deux chiffres qui représentent l'heure dans la notation horaire sur 24 heures, mm sont deux chiffres qui représentent les minutes après l'heure, et ss sont deux chiffres représentant les secondes. Par exemple, la chaîne 18:23:44 représente 23 minutes et 44 secondes après 18h La mémoire tampon doit etre longue d'au moins 9 octets.

_wstrtime est une version caractères larges de _strtime; l'argument et la valeur de retour de _wstrtime sont des chaînes de caractères larges. Ces fonctions se comportent de la même manière dans le cas contraire. Si timestr est un pointeur NULL ou si timestr est mis en forme de manière incorrecte, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exception est autorisée à continuer, ces fonctions retournent NULL et définissent errno à EINVAL si timestr est NULL ou définissent errno à ERANGE si timestr est mis 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.

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_MBCS défini	_UNICODE défini
_tstrtime	_strtime	_strtime	_wstrtime

Configuration requise

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

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

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 );
}