_strdate, _wstrdate

Статья
06/09/2015

Копируют текущую системную дату в буфер. Существуют более безопасные версии этих функций; см. раздел _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

Параметры

datestr
Указатель на буфер, содержащий форматированную строку даты.

Возвращаемое значение

Каждая из этих функций возвращает указатель на результирующую символьной строку datestr.

Заметки

Существуют более безопасные версии этих функций; см. раздел _strdate_s, _wstrdate_s. Рекомендуется по возможности использовать более безопасные функции.

Функция _strdate копирует текущую системную дату в буфер, указанный в datestr, в формате mm/dd/yy, где mm — две цифры, представляющее месяц, dd — две цифры, представляющие день, и yy — две цифры последние две цифры года. Например, строка 12/05/99 представляет 5-е декабря 1999. Буфер должен быть по крайней мере 9 байтов длиной.

Если параметр datestr указывает на NULL, вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если выполнение может быть продолжено, эти функции возвращают -1 и устанавливают errno в значение EINVAL.

_wstrdate — это двухбайтовая версия функции _strdate; аргумент и возвращаемое значение _wstrdate являются строками двухбайтовых символов. В остальном эти функции ведут себя идентично.

В C++ эти функции имеют шаблонные перегрузки, которые вызывают более новые и безопасные аналоги этих функций. Дополнительные сведения см. в разделе Безопасные перегрузки шаблонов.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_tstrdate	_strdate	_strdate	_wstrdate

Требования

Подпрограмма	Обязательный заголовок
_strdate	<time.h>
_wstrdate	<time.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

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