Administración de 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, , _ctime32_s_ctime64_s_wctime_s_wctime32_s_ctime_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.