_strdate, _wstrdate

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

Замечания

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

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

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

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

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

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Сопоставления подпрограмм универсального текста

Подпрограмма 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
}

OS date: 04/25/03

См. также

Управление временем
asctime, _wasctime
ctime, , _ctime32_wctime_ctime64_wctime32,_wctime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
mktime, , _mktime32_mktime64
time, , _time32_time64
_tzset