Управление временем

Эти функции следует использовать для получения текущего времени, его преобразования, корректировки и хранения, как требуется. Текущее время представляет собой системное время.

Подпрограммы _ftime и localtime используют переменную среды TZ . Если TZ не задано, библиотека времени выполнения пытается использовать сведения часового пояса, указанные операционной системой. Если такие сведения недоступны, эти функции используют значение по умолчанию PST8PDT. Дополнительные сведения смTZ. в разделе ; см. в разделе _tzset, timezoneа _tzname_daylightтакже .

Подпрограммы времени

Функция	Использование
asctime, _wasctime, asctime_s, _wasctime_s	Преобразуют время из типа struct tm в символьную строку. Версии этих функций с суффиксом _s являются более безопасными.
clock	Возвращают реальное прошедшее время для процесса.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s	Преобразуют время из типа time_t, __time32_t или __time64_t в символьную строку. Версии этих функций с суффиксом _s являются более безопасными.
difftime, _difftime32, _difftime64	Вычисляют разницу между двумя значениями времени.
_ftime, , _ftime32,_ftime32_s_ftime64_ftime_s _ftime64_s	Хранение текущего системного времени в переменной типа struct _timeb или struct __timeb64 Версии этих функций с суффиксом _s являются более безопасными.
_futime, _futime32, _futime64	Задают время изменения открытого файла
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s	Преобразование времени из типа в struct tm тип time_t или из типа struct tm__time64_t в . Версии этих функций с суффиксом _s являются более безопасными.
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s	Преобразуют время из типа time_t в struct tm или из типа __time64_t в struct tm с поправкой на местное время. Версии этих функций с суффиксом _s являются более безопасными.
_mkgmtime, _mkgmtime32, _mkgmtime64	Преобразовывают время в календарное значение по времени GMT.
mktime, _mktime32, _mktime64	Преобразовывают время в календарное значение.
_strdate, _wstrdate, _strdate_s, _wstrdate_s	Возвращают текущую дату системы в виде строки. Версии этих функций с суффиксом _s являются более безопасными.
strftime, wcsftime, _strftime_l, _wcsftime_l	Форматируют строку даты и времени для международного использования.
_strtime, _wstrtime, _strtime_s, _wstrtime_s	Возвращают текущее системное время в виде строки. Версии этих функций с суффиксом _s являются более безопасными.
time, _time32, _time64	Получают текущее системное время как значение типа time_t, __time32_t или __time64_t.
_tzset	Задает значения внешних переменных времени но основе значения переменной времени среды TZ.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64	Задают время изменения указанного файла, используя либо текущее время, либо значение времени, хранящееся в структуре.

Примечание.

Во всех версиях Microsoft C/C++, кроме версии Microsoft C/C++ 7.0, и во всех версиях Visual C++ эта функция времени возвращает текущее время как количество секунд, прошедших с полуночи 1-го января 1970 года. В версии Microsoft C/C++ 7.0 функция time возвращает текущее время как количество секунд, истекших с полуночи 31-го декабря 1899 года.

Примечание.

В версиях Visual C++ и Microsoft C++ до Visual Studio 2005 time_t было long int (32 бита) и поэтому не может использоваться для дат за последние 3:14:07 19 января 2038 г. в формате UTC. Теперь типtime_t по умолчанию эквивалентен типу __time64_t , но при задании директивы _USE_32BIT_TIME_T тип time_t изменяется на тип __time32_t and forces many time functions изменяется на тип call versions that take the 32-bit time_t. Дополнительные сведения см. в документации по стандартным типам и комментариям для отдельных функций времени.

См. также

Универсальные подпрограммы среды выполнения C по категориям