_strtime, _wstrtime

Статья
06/09/2015

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

char *_strtime(
   char *timestr 
);
wchar_t *_wstrtime(
   wchar_t *timestr 
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

Параметры

timestr
Строка времени.

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

Возвращает указатель на результирующую строку символов timestr.

Заметки

Функция _strtime копирует текущее местное время в буфер, указанный в timestr*.* Время форматируется как hh:mm:ss, где hh является двумя цифрами, представляющими час в 24-часовой записи, mm является двумя цифрами, представляющими минуты, прошедшие с последнего часа, и ss является двумя цифрами, представляющими секунды. Например, строка 18:23:44 представляет 23 минуты и 44 секунды, прошедших с 18 часов. Буфер должен быть по крайней мере 9 байтов длиной.

_wstrtime — это двухбайтовая версия функции _strtime; аргумент и возвращаемое значение _wstrtime являются строками двухбайтовых символов. В противном случае эти функции ведут себя идентично. Если timestr является указателем на NULL, или если timestr форматируется некорректно, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если выполнение может быть продолжено, эти функции возвращают NULL и устанавливают errno в EINVAL при timestr, равном NULL, или устанавливают errno в ERANGE, если timestr форматируется некорректно.

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

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

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_tstrtime	_strtime	_strtime	_wstrtime

Требования

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

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

Пример

// crt_strtime.c
// compile with: /W3

#include <time.h>
#include <stdio.h>

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}