Administración del tiempo

 

Publicado: octubre de 2016

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Use estas funciones para obtener la hora actual y convertirla, ajustarla y almacenarla según sea necesario. La hora actual es la hora del sistema.

Las rutinas _ftime y localtime usan la variable de entorno TZ. Si no se establece el valor de TZ, la biblioteca de tiempo de ejecución intenta usar la información de zona horaria especificada por el sistema operativo. Si esta información no está disponible, estas funciones usan el valor predeterminado de PST8PDT. Para obtener más información sobre TZ, consulte _tzset; consulte también _daylight, timezone, and _tzname.

Rutinas de tiempo

FunciónUsoEquivalente de .NET Framework
asctime, _wasctime, asctime_s, _wasctime_sConvertir la hora de tipo struct tm a cadena de caracteres. Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
clockDevolver el tiempo de reloj transcurrido en el proceso.No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_sConvertir la hora de tipo time_t, __time32_t o __time64_t a cadena de caracteres. Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::GetDateTimeFormats, System::DateTime::ToString, System::DateTime::ToLongTimeString, System::DateTime::ToShortTimeString
difftime, _difftime32, _difftime64Calcular la diferencia entre dos horas.System::DateTime::Subtract
_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_sAlmacenar la hora actual del sistema en la variable de tipo struct _timeb o de tipo struct``__timeb64 Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::Now
_futime, _futime32, _futime64Definir la hora de modificación del archivo abierto.System::IO::File::SetLastAccessTime, System::IO::File::SetLastWriteTime, System::IO::File::SetCreationTime
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_sConvertir la hora del tipo time_t al struct tm o del tipo __time64_t al struct tm.Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::UtcNow, System::DateTime::ToUniversalTime
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_sConvertir la hora de tipo time_t a struct tm o del tipo __time64_t a struct tm con corrección local. Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::ToLocalTime
_mkgmtime, _mkgmtime32, _mkgmtime64Convertir la hora a un valor de calendario en formato de la Hora del meridiano de Greenwich.System::DateTime::ToUniversalTime
mktime, _mktime32, _mktime64Convertir la hora a un valor de calendario.System::DateTime::DateTime
_strdate, _wstrdate, _strdate_s, _wstrdate_sDevolver la fecha actual del sistema como cadena. Las versiones de estas funciones con el sufijo _s son más seguras.No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
strftime, wcsftime, _strftime_l, _wcsftime_lDar formato a la cadena de fecha y hora para uso internacional.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
_strtime, _wstrtime, _strtime_s, _wstrtime_sDevolver la hora actual del sistema como cadena. Las versiones de estas funciones con el sufijo _s son más seguras.System::DateTime::ToLongDateString, System::DateTime::ToLongTimeString, System::DateTime::ToShortDateString, System::DateTime::ToShortTimeString, System::DateTime::ToString
time, _time32, _time64Obtener la hora actual del sistema como tipo time_t, __time32_t o como tipo __time64_t.No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
_tzsetDefinir variables externas de tiempo desde la variable de tiempo de entorno TZ.No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64Definir la hora de modificación del archivo especificado mediante la hora actual o el valor de hora almacenado en la estructura.No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
System_CAPS_ICON_note.jpg Nota

En todas las versiones de Microsoft C/C++, excepto Microsoft C/C++ versión 7.0, y en todas las versiones de Visual C++, la función de hora devuelve la hora actual como el número de segundos transcurridos desde la medianoche del 1.° de enero de 1970. En Microsoft C/C++ versión 7.0, el valor time devolvió la hora actual como el número de segundos transcurridos desde la medianoche del 31 de diciembre de 1899.

System_CAPS_ICON_note.jpg Nota

En versiones de Visual C++ y Microsoft C/C++ anteriores a Visual C++ 2005, el valor time_t fue long int (32 bits) y, por lo tanto, no se pudo usar para fechas después de las 3:14:07 del 19 de enero de 2038, hora UTC. El valor time_t ahora es equivalente a __time64_t de manera predeterminada, pero si se define _USE_32BIT_TIME_T , se cambia time_t a __time32_t y fuerza a muchas funciones de hora a llamar a las versiones que usan el valor time_t de 32 bits. Para obtener más información, consulte Tipos estándar y comentarios en la documentación sobre las funciones individuales de hora.

Rutinas de tiempo de ejecución por categoría

Mostrar: