_strdate, _wstrdate

Kopieren des aktuellen Systemdatums in einen Puffer Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _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. Informationen dazu finden Sie unter _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 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

Anforderungen

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