Управление временем
Эти функции следует использовать для получения текущего времени, его преобразования, корректировки и хранения, как требуется. Текущее время представляет собой системное время.
Подпрограммы _ftime и localtime используют переменную среды TZ . Если TZ не задано, библиотека времени выполнения пытается использовать сведения часового пояса, указанные операционной системой. Если такие сведения недоступны, эти функции используют значение по умолчанию PST8PDT. Дополнительные сведения смTZ. в разделе ; см. в разделе _tzset, timezoneа _tzname_daylightтакже .
Подпрограммы времени
| Function | Использование |
|---|---|
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,_ftime32_s_ftime64_ftime_s _ftime64_s |
Хранение текущего системного времени в переменной типа struct _timeb или struct __timeb64 Версии этих функций с суффиксом _s являются более безопасными. |
_futime, , _futime32_futime64 |
Задают время изменения открытого файла |
gmtime, , _gmtime32gmtime_s_gmtime64_gmtime32_s,_gmtime64_s |
Преобразование времени из типа в struct tm тип time_t или из типа struct tm__time64_t в . Версии этих функций с суффиксом _s являются более безопасными. |
localtime, , _localtime32localtime_s_localtime64_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_wutime_utime64_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. Дополнительные сведения см. в документации по стандартным типам и комментариям для отдельных функций времени.