Управление временем
Эти функции следует использовать для получения текущего времени, его преобразования, регулировки и хранения, при необходимости. Текущее время - это системное время.
Процедуры _ftime и localtime используют переменную среды TZ. Если значение TZ не задано, то библиотеки времени выполнения пытается использовать данные часового пояса, определенные операционной системой. Если эти сведения недоступны, то эти функции используют значение по умолчанию PST8PDT. Дополнительные сведения о TZ см. в разделе _tzset; также см. раздел _daylight, timezone, and _tzname.
Процедуры времени
Функция |
Применение |
Эквивалент в .NET Framework |
|---|---|---|
Преобразуют время из типа struct tm в символьную строку. Версии этих функций с суффиксом _s являются более безопасными. |
System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString |
|
Возвращают затраченное реальное время для процесса. |
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода. |
|
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s |
Преобразуют время из типа time_t, __time32_t or __time64_t в символьную строку. Версии этих функций с суффиксом _s являются более безопасными. |
System::DateTime::GetDateTimeFormats, System::DateTime::ToString, System::DateTime::ToLongTimeString, System::DateTime::ToShortTimeString |
Вычисляют разницу между двумя временами. |
||
Хранят текущее системное время в переменной типа struct _timeb или типа struct __timeb64. Версии этих функций с суффиксом _s являются более безопасными. |
||
Задают время модификации открытого файла |
System::IO::File::SetLastAccessTime, System::IO::File::SetLastWriteTime, System::IO::File::SetCreationTime |
|
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s |
Преобразовывают время из типа time_t в struct tm или из типа __time64_t в struct tm.Версии этих функций с суффиксом _s являются более безопасными. |
|
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s |
Преобразовывают время из типа time_t в struct tm или из типа __time64_t в struct tmс коррекцией на локальное время. Версии этих функций с суффиксом _s являются более безопасными. |
|
Преобразовывают время в календарное значение по времени GMT. |
||
Преобразовывают время в календарное значение. |
||
Возвращают текущую дату системы в виде строки. Версии этих функций с суффиксом _s являются более безопасными. |
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода. |
|
Форматируют строку дату и времени для международного использования. |
System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString |
|
Возвращают текущее время системы в виде строки. Версии этих функций с суффиксом _s являются более безопасными. |
System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString |
|
Получают текущее время системы как значение типа time_t, __time32_t или типа __time64_t. |
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода. |
|
Задаёт значения внешних переменных времени из значения переменной времени среды TZ. |
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода. |
|
Задает время модификации указанного файла, используя либо текущее время, либо значение времени, хранящееся в структуре. |
Неприменимо. Для вызова стандартной функции C используйте PInvoke. Дополнительные сведения см. в разделе Примеры вызовов неуправляемого кода. |
Примечание
Во всех версиях Microsoft C/C++, кроме версии Microsoft C/C++ 7.0, и во всех версиях Visual C++ эта функция времени возвращает текущее время как количество секунд, прошедших с полуночи 1-го января 1970 года.В версии Microsoft C/C++ 7.0 time возвращает текущее время как число секунд, истекших с полуночи 31-го декабря 1899.
Примечание
В версиях Visual C++ и Microsoft C/C++ до Visual C++ 2005 time_t был long int (32-разрядный), и поэтому не мог быть использован для дат после 3:14:07 19 января 2038, время в формате UTC.time_t теперь равен __time64_t по умолчанию, но указание _USE_32BIT_TIME_T изменяет time_t до __time32_t и приводит к тому, что множество функций времени вызывают версии, которые принимают 32-разрядный time_t.Дополнительные сведения см. в Стандартные типы и комментариях в документации для отдельных функций времени.