Управление временем
Эти функции следует использовать для получения текущего времени, его преобразования, корректировки и хранения, как требуется. Текущее время представляет собой системное время.
Подпрограммы _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
. Дополнительные сведения см. в документации по стандартным типам и комментариям для отдельных функций времени.
См. также
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по