_strtime, _wstrtime

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

La durée d’une mémoire tampon de copie. Des versions plus sécurisées de ces fonctions sont disponibles. consultez la page _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 d’heure.

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

Le _strtime fonction copie l’heure locale actuelle dans la mémoire tampon vers laquelle pointée timestr . L’heure est mis en forme en tant que hh:mm:sshh comprend deux chiffres qui représente l’heure 24 heures, mm comprend deux chiffres représentant les minutes après l’heure, et ss correspond à deux chiffres représentant 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 être 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 comme dans le cas contraire. Si timestr est NULL pointeur ou si timestr est incorrect, non valide Gestionnaire de paramètre est appelé, comme décrit dans Validation de paramètre. Si l’exception est autorisée à se poursuivre, ces fonctions retournent une valeur NULL et le jeu de errno à EINVAL si timestr a une valeur NULL ou définir errno à ERANGE si timestr est incorrect.

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 Secure Template Overloads.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tstrtime_strtime_strtime_wstrtime
RoutineEn-tête requis
_strtime<time.h>
_wstrtime<time.h>ou<wchar.h></wchar.h></time.h>

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

// 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  

Gestion du temps
asctime, _wasctime
CTime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
LocalTime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
heure, _time32, _time64
_tzset

Afficher: