Partager via


_strtime, _wstrtime

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

Équivalent .NET Framework

Voir aussi

Référence

Gestion du temps

asctime, _wasctime

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

mktime, _mktime32, _mktime64

time, _time32, _time64

_tzset