Udostępnij za pośrednictwem

_strdate, _wstrdate

  • Artykuł

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ść errno EINVAL.

_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 zdefiniowany _UNICODE zdefiniowany
_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