_strtime, _wstrtime

Article
03/26/2013

Copiez le temps une mémoire tampon.plus les versions 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 de temps.

Valeur de retour

Retourne un pointeur vers la chaîne de caractères résultant timestr.

Notes

La fonction d' _strtime copie l'heure locale actuelle dans la mémoire tampon désignée par timestr*.* Il est mis en forme comme un hh:mm:ss où hh est deux chiffres représentant l'heure en notation de 24 heures, mm est deux chiffres représentant les minutes après l'heure, et ss est deux chiffres qui représente les secondes.Par exemple, la chaîne 18:23:44 représente 23 minutes et 44 secondes au delà de le 18hLa mémoire tampon doit être au moins de 9 octets.

_wstrtime est une version à caractère élargi d' _strtime; l'argument et que la valeur de retour d' _wstrtime sont des chaînes à caractères larges.Ces fonctions se comportent de sinon. Si timestr est pointeur d' NULL ou si timestr est mis en forme correctement, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si sont autorisées à se poursuivre, ces fonctions retournent NULL et errno défini à EINVAL si timestr est NULL ou errno défini à ERANGE si timestr est mis en forme correctement.

En C++, ces fonctions ont des surcharges de modèle qui appellent des homologues plus récentes et sécurisées de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

mappages de routines de texte générique

routine de TCHAR.H	_MBCS & de _UNICODE non défini	_MBCS défini	_UNICODE défini
_tstrtime	_strtime	_strtime	_wstrtime

Configuration requise

routine	en-tête requis
_strtime	<time.h>
_wstrtime	<time.h> ou <wchar.h>

Pour des informations de compatibilité supplémentaires, 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 );
}