_strdate, _wstrdate

Kopieren des aktuellen Systemdatums in einen Puffer Sicherere Versionen dieser Funktionen sind verfügbar; siehe _strdate_s, _wstrdate_s.

Syntax

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 datestr zurück.

Hinweise

Sicherere Versionen dieser Funktionen sind verfügbar; siehe _strdate_s, _wstrdate_s. Es wird empfohlen, möglichst sicherere Funktionen zu verwenden.

Die _strdate Funktion kopiert das aktuelle Systemdatum in den Puffer, auf datestrden durch , formatiert mm/tt/yyy, wobei mm zwei Ziffern, die den Monat darstellen, dd zwei Ziffern darstellt, den Tag darstellt, und yy ist die letzten beiden Ziffern des Jahres. Beispiel: Die Zeichenfolge 12/05/99 stellt das Datum 5. Dezember 1999 dar. Der Puffer muss mindestens 9 Bytes lang sein.

Wenn datestr es sich um einen NULL Zeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen "– 1" zurück und legen errno auf EINVALfest.

_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".

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS Definiert	_UNICODE Definiert
_tstrdate	_strdate	_strdate	_wstrdate

Anforderungen

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

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

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
}

OS date: 04/25/03

Siehe auch

Zeitverwaltung
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset