_strdate, _wstrdate

Skopiuj bieżącą datę systemu do buforu. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz _strdate_s, _wstrdate_s.

Składnia

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

Parametry

datestr
Wskaźnik do buforu zawierającego sformatowany ciąg daty.

Wartość zwracana

Każda z tych funkcji zwraca wskaźnik do wynikowego ciągu datestrznaków .

Uwagi

Dostępne są bezpieczniejsze wersje tych funkcji; zobacz _strdate_s, _wstrdate_s. Zaleca się, aby w miarę możliwości używać bezpieczniejszych funkcji.

Funkcja _strdate kopiuje bieżącą datę systemową do buforu wskazywanego przez datestr, sformatowany mm/dd/yy, gdzie mm to dwie cyfry reprezentujące miesiąc, dd to dwie cyfry reprezentujące dzień, a yy jest dwiema ostatnimi cyframi roku. Na przykład ciąg 12/05/99 reprezentuje 5 grudnia 1999 r. Bufor musi mieć długość co najmniej 9 bajtów.

Jeśli datestr jest wskaźnikiem NULL , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonanie może kontynuować, te funkcje zwracają wartość -1 i ustawiają wartość errnoEINVAL.

_wstrdate jest wersją szerokoznakową ; _strdateargument i wartość zwracana _wstrdate są ciągami o szerokim znaku. Te funkcje zachowują się identycznie inaczej.

W języku C++te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstrdate	_strdate	_strdate	_wstrdate

Wymagania

Procedura	Wymagany nagłówek
_strdate	<time.h>
_wstrdate	<time.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

// 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

Zobacz też

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