Administración del tiempo

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 TZ, la biblioteca en 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 más información sobre TZ, consulte _tzset; consulte también , _daylight, timezone y _tzname.

Rutinas de tiempo

Función	Usar
asctime, _wasctime, asctime_s, _wasctime_s	Convertir la hora de tipo struct tm a cadena de caracteres. Las versiones de estas funciones con el sufijo _s son más seguras.
clock	Devolver el tiempo de reloj transcurrido en el proceso.
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64, _ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s	Convertir 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.
difftime, _difftime32, _difftime64	Calcular la diferencia entre dos horas.
_ftime, _ftime32, _ftime64,_ftime_s, _ftime32_s, _ftime64_s	Almacenar 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.
_futime, _futime32, _futime64	Definir la hora de modificación del archivo abierto.
gmtime, _gmtime32, _gmtime64, gmtime_s, _gmtime32_s, _gmtime64_s	Convertir la hora del tipo time_t a struct tm o del tipo __time64_t a struct tm. Las versiones de estas funciones con el sufijo _s son más seguras.
localtime, _localtime32, _localtime64, localtime_s, _localtime32_s, _localtime64_s	Convertir 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.
_mkgmtime, _mkgmtime32, _mkgmtime64	Convertir la hora a un valor de calendario en formato de la Hora del meridiano de Greenwich.
mktime, _mktime32, _mktime64	Convertir la hora a un valor de calendario.
_strdate, _wstrdate, _strdate_s, _wstrdate_s	Devolver la fecha actual del sistema como cadena. Las versiones de estas funciones con el sufijo _s son más seguras.
strftime, wcsftime, _strftime_l, _wcsftime_l	Dar formato a la cadena de fecha y hora para uso internacional.
_strtime, _wstrtime, _strtime_s, _wstrtime_s	Devolver la hora actual del sistema como cadena. Las versiones de estas funciones con el sufijo _s son más seguras.
time, _time32, _time64	Obtener la hora actual del sistema como tipo time_t, __time32_t o como tipo __time64_t.
_tzset	Definir variables externas de tiempo desde la variable de tiempo de entorno TZ.
_utime, _utime32, _utime64, _wutime, _wutime32, _wutime64	Definir la hora de modificación del archivo especificado mediante la hora actual o el valor de hora almacenado en la estructura.

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.

Nota:

En versiones de Visual C++ y Microsoft C/C+ anteriores a Visual Studio 2005, el valor time_t era long int (32 bits) y, por lo tanto, no se podía usar con fechas después de las 3:14:07 del 19 de enero de 2038, hora UTC. El valortime_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 and forces many time functions a call versions that take the 32-bit time_tde 32 bits. Para obtener más información, consulte Tipos estándar y comentarios en la documentación de las funciones de hora individuales.

Consulte también

Rutinas en tiempo de ejecución Universal C por categoría