_strtime, _wstrtime

Artikel
02/26/2013

Kopieren Sie die Uhrzeit in einen Puffer.Sicherere Versionen dieser Funktionen sind verfügbar. Weitere Informationen 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
Zeichenfolge der Zeit.

Rückgabewert

Gibt einen Zeiger auf die resultierende Zeichenfolge timestrzurück.

Hinweise

Die _strtime-Funktion kopiert die aktuelle lokale Zeit in den Puffer zu, der durch timestrdargestellt wird*.* Die Zeit wird als hh:mm:ss , in dem hh zwei Ziffern besteht darin, die die Stunde in der Notation stündigen 24 darstellen, mm sind zwei Ziffern formatiert, die die Minuten nach der vollen Stunde darstellen, und ss sind zwei Ziffern, die Sekunden darstellen.Beispielsweise stellt die Zeichenfolge 18:23:44 23 Minuten und 44 Sekunden nach 6. P.M dar.Der Puffer muss mindestens 9 Byte lang sein.

_wstrtime ist eine Breitzeichen-Version von _strtime. das Argument und der Rückgabewert von _wstrtime sind Zeichenfolgen mit Breitzeichen.Diese Funktionen verhalten sich ansonsten unterscheiden. Wenn timestrNULL Zeiger ist oder wenn timestr falsch formatiert wird, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn der Ausnahme gestattet ist, um fortzufahren, geben diese Funktionen zu errno Menge NULL- und EINVAL zurück, wenn timestr NULL oder war ERANGE zu errno festlegen, wenn timestr falsch formatiert ist.

In C++ haben Überladungen Vorlagen, die diese Funktionen aufrufen, um das neueres, Entsprechungen dieser Funktionen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuweisung generischer Textroutinen

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

Anforderungen

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

Um Kompatibilität zusätzlichen Informationen 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 );
}