Freigeben über

_strtime, _wstrtime

  • Artikel

Kopieren der Zeit in einen Puffer. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _strtime_s, _wstrtime_s.

Syntax

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 auf die resultierende Zeichenfolge timestr zurück.

Hinweise

Die _strtime Funktion kopiert die aktuelle Ortszeit in den Puffer, auf den verwiesen wird.timestr Die Uhrzeit ist formatiert als hh:mm:ss, wobei hh zwei Ziffern, die die Stunde in 24-Stunden-Schreibweise darstellen. mm ist zwei Ziffern für die Minuten in der letzten Stunde und ss ist zwei Ziffern für Sekunden. Die Zeichenfolge 18:23:44 stellt beispielsweise 23 Minuten und 44 Sekunden nach 6 Uhr dar. Der Puffer muss mindestens 9 Byte lang sein.

_wstrtime ist eine Breitzeichenversion von _strtime. Das Argument und der Rückgabewert von _wstrtime sind Zeichenfolgen mit Breitzeichen. Anderenfalls verhalten sich diese Funktionen identisch. Wenn timestr es sich um einen NULL Zeiger handelt oder timestr falsch formatiert ist, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausnahme fortgesetzt werden darf, geben diese Funktionen einen NULLWert zurück, und legen sie errno fest, EINVAL ob timestr es sich um timestr ERANGE ein NULL oder ein errno falsch formatiertes Format handelt.

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

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

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

Anforderungen

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

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

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

The current time is 14:21:44

Siehe auch

Zeitverwaltung
asctime, _wasctime
ctime, , _ctime32_ctime64, _wctime, , _wctime32_wctime64
gmtime, _gmtime32_gmtime64
localtime, _localtime32_localtime64
mktime, _mktime32_mktime64
time, _time32_time64
_tzset