_strdate, _wstrdate

Artikel
02/26/2013

Laufendes Systemdatum der Kopie auf einen Puffer.Sicherere Versionen dieser Funktionen sind verfügbar. Weitere Informationen 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 auf die resultierende Zeichenfolge datestrzurück.

Hinweise

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

Die _strdate-Funktion kopiert das aktuelle Systemdatum auf den Puffer, der durch datestr, formatiertes mm/dd/yydargestellt wird, wobei mm zwei Ziffern besteht darin, die den Monat darstellen, dd handelt es sich um zwei Ziffern, die den Tag darstellt, und yy ist die letzten zwei Ziffern des Jahres.Beispielsweise stellt die Zeichenfolge 12/05/99 am 5. Dezember 1999 dar.Der Puffer muss mindestens 9 Byte lang sein.

Wenn datestr ein NULL Zeiger ist, wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn die Ausführung ermöglicht wird, um fortzufahren, geben diese Funktionen festlegen und -1 errno zu EINVALzurück.

_wstrdate ist eine Breitzeichen-Version von _strdate. das Argument und der Rückgabewert von _wstrdate sind Zeichenfolgen mit Breitzeichen.Diese Funktionen verhalten sich ansonsten unterscheiden.

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

Anforderungen

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

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