Поделиться через

_strtime, _wstrtime

  • Статья

Копируют время в буфер. Доступны более безопасные версии этих функций; see _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 секунды после 6 вечера. Буфер должен быть не менее 9 байтов.

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

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

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

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

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

The current time is 14:21:44

См. также

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