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

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

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

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

Функция	Использование
asctime, , _wasctimeasctime_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, _ftime64_ftime_s_ftime32_s_ftime64_s	Хранение текущего системного времени в переменной типа struct _timeb или struct __timeb64 Версии этих функций с суффиксом _s являются более безопасными.
_futime, , _futime32_futime64	Задают время изменения открытого файла
gmtime, , _gmtime32_gmtime64gmtime_s_gmtime32_s,_gmtime64_s	Преобразование времени из типа в time_t тип struct tm или из типа __time64_tstruct tm в . Версии этих функций с суффиксом _s являются более безопасными.
localtime, , _localtime32_localtime64localtime_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 по категориям