_strdate, _wstrdate

Artikel
06/09/2015

Laufendes Systemdatum der Kopie zu einem Puffer. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _strdate_s, _wstrdate_s.

char *_strdate(
   char *datestr 
);
wchar_t *_wstrdate(
   wchar_t *datestr 
);
template <size_t size>
char *_strdate(
   char (&datestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrdate(
   wchar_t (&datestr)[size]
); // C++ only

Parameter

datestr
Ein Zeiger auf einen Puffer, der die formatierte Datumszeichenfolge enthält.

Rückgabewert

Jede dieser Funktionen gibt einen Zeiger in die resultierende Zeichenfolge datestr zurück.

Hinweise

Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _strdate_s, _wstrdate_s. Es wird empfohlen, dass der sichereren Funktionen nach Möglichkeit verwendet werden.

Die Funktion _strdate kopiert das aktuelle Systemdatum dem Puffer, auf den durch datestr, formatiertes mm/dd/yy gezeigt wird, wobei mm zwei Ziffern ist, die den Monat darstellen, ist dd zwei Ziffern, die den Tag darstellen, und yy ist die letzten beiden Stellen des Jahrs. Beispielsweise stellt die Zeichenfolge 12/05/99 am 5. Dezember 1999 dar. Der Puffer muss mindestens 9 Bytes lang sein.

Wenn datestr ein NULL-Zeiger ist, wird der Handler für ungültige Parameter aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen "– 1" zurück und legen errno auf EINVAL fest.

_wstrdate ist eine Breitzeichenversion von _strdate. Das Argument und der Rückgabewert von _wstrdate sind Zeichenfolgen mit Breitzeichen. Anderenfalls verhalten sich diese Funktionen identisch.

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
_tstrdate	_strdate	_strdate	_wstrdate

Anforderungen

Routine	Erforderlicher Header
_strdate	<time.h>
_wstrdate	<time.h oder> wchar.h <>

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

Beispiel

// strdate.c
// compile with: /W3
#include <time.h>
#include <stdio.h>
int main()
{
    char tmpbuf[9];
   
    // Set time zone from TZ environment variable. If TZ is not set,
    // the operating system is queried to obtain the default value 
    // for the variable. 
    //
    _tzset();

    printf( "OS date: %s\n", _strdate(tmpbuf) ); // C4996
    // Note: _strdate is deprecated; consider using _strdate_s instead
}