Librería time para manipulación de fechas y horas

26/06/2025

★★★★★Valoración: 3.51 (1669 votos)

La gestión del tiempo es fundamental en la programación, y las librerías dedicadas a esta tarea son esenciales para cualquier desarrollador. En este artículo, exploraremos en detalle la librería time, tanto en C como en Python, analizando sus funciones, constantes, tipos de datos y ejemplos prácticos para que puedas aprovechar al máximo sus capacidades.

Temario

Librería time en C: Formato de hora y fecha

En C, la librería time.h proporciona un conjunto de funciones para manipular fechas y horas del sistema. A continuación, se detallan algunas de las funciones más importantes:

Funciones de la librería time.h

Función Descripción
char asctime(struct tm ) Convierte una estructura tm a una cadena de caracteres con formato "Www Mmm dd hh:mm:ss yyyy".
clock_t clock(void) Devuelve el número de ticks de reloj desde el inicio del proceso.
char ctime(time_t ) Convierte un valor time_t a una cadena con el mismo formato que asctime() .
double difftime(time_t, time_t) Calcula la diferencia en segundos entre dos valores time_t .
struct tm gmtime(time_t ) Convierte un valor time_t a una estructura tm representando la hora UTC.
struct tm localtime(time_t ) Convierte un valor time_t a una estructura tm representando la hora local.
time_t mktime(struct tm ) Convierte una estructura tm a un valor time_t .
time_t time(time_t ) Devuelve la hora actual como un valor time_t .
size_t strftime(char , size_t, const char , const struct tm ) Formatea una estructura tm en una cadena de caracteres según un formato especificado.

Constantes de la librería time.h

Constante Descripción
CLK_PER_SEC Número de ticks de reloj por segundo.
CLOCKS_PER_SEC Alternativa a CLK_PER_SEC .
CLK_TCK Generalmente una macro para CLK_PER_SEC .

Tipos de datos de la librería time.h

Tipo de dato Descripción
clock_t Tipo de dato devuelto por clock() , generalmente un long int .
time_t Tipo de dato devuelto por time() , generalmente un long int .
struct tm Representación del tiempo en formato de calendario. Contiene miembros como tm_sec , tm_min , tm_hour , tm_mday , tm_mon , tm_year , etc.

Ejemplo de uso de la librería time.h en C

El siguiente código muestra un ejemplo básico de cómo obtener la hora actual y formatearla usando time()y strftime():

#include <stdio.h>#include <time.h>int main() { time_t tiempoActual; struct tm tiempoDesglosado; char buffer[80]; time(&tiempoActual); tiempoDesglosado = localtime(&tiempoActual); strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", tiempoDesglosado); printf("La hora actual es: %s", buffer); return 0;}

Módulo time en Python: Acceso y conversiones de tiempo

El módulo time en Python ofrece una amplia gama de funciones para trabajar con tiempo. Aunque está siempre disponible, la disponibilidad de ciertas funciones puede variar según la plataforma.

Terminología y convenciones del módulo time en Python

  • Epoch: Punto de inicio del tiempo, generalmente 1 de enero de 1970, 00:00:00 UTC.
  • Segundos desde la epoch: Número total de segundos transcurridos desde la epoch, excluyendo segundos bisiestos.
  • UTC: Hora Universal Coordinada.
  • Horario de verano (DST): Ajuste de la zona horaria.

Funciones del módulo time en Python

El módulo timeen Python proporciona funciones para diversas tareas relacionadas con el tiempo. Algunas de las más importantes incluyen:

  • time.sleep(seconds) : Pausa la ejecución del programa por un número determinado de segundos.
  • time.time() : Devuelve el número de segundos transcurridos desde la epoch.
  • time.gmtime([seconds]) : Convierte segundos desde la epoch a una tupla struct_time en UTC.
  • time.localtime([seconds]) : Convierte segundos desde la epoch a una tupla struct_time en hora local.
  • time.ctime([seconds]) : Convierte segundos desde la epoch a una cadena legible por humanos.
  • time.strftime(format, [tuple]) : Formatea una tupla struct_time en una cadena con un formato específico.
  • time.strptime(string, format) : Analiza una cadena con formato de tiempo y la convierte en una tupla struct_time .
  • time.mktime(tuple) : Convierte una tupla struct_time a segundos desde la epoch.

Constantes de reloj del módulo time en Python

El módulo timetambién define varias constantes de reloj, que se utilizan para especificar diferentes tipos de relojes del sistema. Estas constantes se utilizan con las funciones clock_getres()y clock_gettime()(disponibles en sistemas Unix). Algunos ejemplos incluyen:

  • time.CLOCK_MONOTONIC
  • time.CLOCK_REALTIME
  • time.CLOCK_PROCESS_CPUTIME_ID
  • time.CLOCK_THREAD_CPUTIME_ID

Ejemplo de uso del módulo time en Python

El siguiente código muestra un ejemplo de cómo utilizar algunas de las funciones del módulo time:

import timetiempoActual = time.time()print(f"Tiempo desde la epoch: {tiempoActual} segundos")tiempoLocal = time.localtime(tiempoActual)print(f"Tiempo local: {tiempoLocal}")tiempoFormateado = time.strftime("%Y-%m-%d %H:%M:%S", tiempoLocal)print(f"Tiempo formateado: {tiempoFormateado}")time.sleep(2)print("Esperando 2 segundos...")

Funciones de fecha en otras librerías

Además de las librerías time.h(C) y time(Python), existen otras funciones para trabajar con fechas, como las funciones de fecha y hora integradas en hojas de cálculo (como Excel o Google Sheets):

  • FECHA: Devuelve el número de serie correspondiente a una fecha determinada.
  • SIFECHA: Calcula la diferencia en días, meses o años entre dos fechas.
  • DATEVALUE: Convierte una fecha en formato de texto a un valor numérico de serie.
  • DIA, MES, AÑO, HORA, MINUTO, SEGUNDO: Extraen componentes específicos de una fecha o hora.
  • DIAS, DIAS360: Calculan el número de días entre dos fechas.
  • FECHA.MES, FIN.MES: Calculan fechas desplazadas en meses.
  • ISO.NUM.DE.SEMANA: Devuelve el número de semana ISO.
  • DIAS.LAB, DIAS.LAB.INTL: Calculan días laborables entre dos fechas.
  • AHORA: Devuelve la fecha y hora actuales.
  • HOY: Devuelve la fecha actual.
  • DIASEM: Devuelve el día de la semana.
  • NUM.DE.SEMANA: Devuelve el número de semana del año.
  • DIA.LAB, DIA.LAB.INTL: Calculan fechas desplazadas en días laborables.

Estas funciones ofrecen una forma sencilla de manipular fechas y horas en entornos de hojas de cálculo, complementando las funcionalidades de las librerías timeespecíficas de los lenguajes de programación.

Conclusión

Las librerías time en C y Python son herramientas esenciales para la manipulación de fechas y horas. Su comprensión y aplicación adecuada es crucial para desarrollar aplicaciones robustas y eficientes. Recuerda explorar la documentación completa de cada librería para descubrir todas sus funciones y posibilidades. La correcta gestión del tiempo es fundamental en cualquier programa, y estas librerías te brindan las herramientas necesarias para lograrlo.

Si quieres conocer otros artículos parecidos a Librería time para manipulación de fechas y horas puedes visitar la categoría Libros y Librerías.

Subir