_strtime, _wstrtime

Artikel
06/09/2015

Kopieren Sie die Uhrzeit in einem Puffer. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _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

Parameter

timestr
Zeitzeichenfolge.

Rückgabewert

Gibt einen Zeiger in die resultierende Zeichenfolge timestr zurück.

Hinweise

Die _strtime-Funktion wird die aktuelle Ortszeit in den Puffer, auf den durch timestr gezeigt wird . Die Zeit wird als hh:mm:ss, wobei hh zwei Ziffern ist, die die Uhrzeit im 24 der Notation mm darstellen, werden zwei Ziffern formatiert, die die Minuten nach der Stunde darstellen, und ss sind zwei Ziffern, die darstellen Sekunden. Beispielsweise stellt die Zeichenfolge 18:23:44 23 Minuten und 44 Sekunden nach 6 Uhr dar Der Puffer muss mindestens 9 Bytes lang sein.

_wstrtime ist eine Breitzeichenversion von _strtime. Das Argument und der Rückgabewert von _wstrtime sind Zeichenfolgen mit Breitzeichen. Diese Funktionen identisch verhalten sich andernfalls. Wenn timestrNULL Zeiger ist, oder wenn timestr falsch formatiert wird, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben. Wenn die Ausnahme gestattet wird, um fortzufahren, geben diese Funktionen einer NULL und eine Gruppe von errno in EINVAL zurück, wenn timestr eine Null oder ein Satz von errno in ERANGE, wenn timestr war falsch formatiert ist.

In C++ haben diese Funktionen Vorlagenüberladungen, mit denen die neueren, sicheren Entsprechungen dieser Funktionen aufgerufen werden. Weitere Informationen finden Sie unter Sichere Vorlagenüberladungen.

Zuordnung generischer Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tstrtime	_strtime	_strtime	_wstrtime

Anforderungen

Routine	Erforderlicher Header
_strtime	<time.h>
_wstrtime	<time.h oder> wchar.h <>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

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