04/06/2006
La librería time en Python es una herramienta esencial para cualquier desarrollador que trabaje con tareas relacionadas al tiempo. Ofrece una amplia gama de funciones para leer la hora actual, formatearla, pausar la ejecución del programa y realizar diversas operaciones cronológicas. Este artículo profundiza en las funcionalidades clave de esta librería, proporcionando ejemplos prácticos y explicaciones detalladas.
- Funciones Principales de la Librería Time
- time.time() : Obteniendo el Tiempo en Segundos
- time.ctime() : Conversión a Formato de Fecha y Hora Lecible
- time.sleep() : Pausando la Ejecución
- time.localtime() : Obteniendo una Estructura de Tiempo Local
- time.gmtime() : Obteniendo una Estructura de Tiempo UTC
- time.mktime() : Conversión de struct_time a Segundos
- time.asctime() : Formato de struct_time a Cadena de Texto
- time.strftime() : Formateo de Fecha y Hora Personalizado
- time.strptime() : Análisis de Cadenas de Tiempo
- Tabla Comparativa de Funciones
- Consultas Frecuentes
- Conclusión
Funciones Principales de la Librería Time
La librería timeproporciona una variedad de funciones que abarcan diferentes aspectos de la manipulación del tiempo. A continuación, se detallan algunas de las más importantes:

time.time() : Obteniendo el Tiempo en Segundos
La función time.time() es fundamental. Devuelve el número de segundos transcurridos desde la época ( epoch), que generalmente es el 1 de enero de 1970, a las 00:00:00 UTC. Este valor es un número de punto flotante. La precisión depende del sistema operativo.
import timeseconds = time.time()print(f"Segundos desde la época: {seconds}")time.ctime() : Conversión a Formato de Fecha y Hora Lecible
La función time.ctime() toma como argumento un número de segundos desde la época (como el obtenido con time.time()) y retorna una cadena de texto que representa la fecha y hora en formato local.

import timeseconds = 1672215375045543local_time = time.ctime(seconds)print(f"Hora local: {local_time}")time.sleep() : Pausando la Ejecución
La función time.sleep() detiene la ejecución del programa durante un número específico de segundos. Es útil para crear pausas, sincronizar procesos o simular retrasos.
import timeprint("Mensaje 1")time.sleep(2) # Pausa de 2 segundosprint("Mensaje 2")time.localtime() : Obteniendo una Estructura de Tiempo Local
La función time.localtime() retorna una tupla struct_timeque contiene información sobre la hora local. Si no se proporciona argumento, utiliza la hora actual.

import timetiempo_local = time.localtime()print(f"Tiempo local: {tiempo_local}")print(f"Año: {tiempo_local.tm_year}")print(f"Hora: {tiempo_local.tm_hour}")time.gmtime() : Obteniendo una Estructura de Tiempo UTC
Similar a time.localtime(), pero retorna la hora en Tiempo Universal Coordinado (UTC).
import timetiempo_utc = time.gmtime()print(f"Tiempo UTC: {tiempo_utc}")time.mktime() : Conversión de struct_time a Segundos
La función time.mktime() realiza la operación inversa a time.localtime()y time.gmtime(). Toma una tupla struct_timecomo argumento y devuelve el número de segundos desde la época que representa.
import timetiempo_tupla = (2024, 1, 15, 10, 30, 0, 0, 0, 0) # Año, mes, dia, hora, minuto, segundo, dia de la semana, dia del año, horario de veranosegundos = time.mktime(tiempo_tupla)print(f"Segundos desde la época: {segundos}")time.asctime() : Formato de struct_time a Cadena de Texto
Convierte una tupla struct_timea una cadena de texto legible.
import timetiempo_tupla = (2024, 1, 15, 10, 30, 0, 0, 0, 0)cadena_tiempo = time.asctime(tiempo_tupla)print(f"Cadena de tiempo: {cadena_tiempo}")time.strftime() : Formateo de Fecha y Hora Personalizado
Permite formatear la fecha y hora de acuerdo a un formato especificado usando códigos de formato. Ofrece un control preciso sobre la salida.
import timetiempo_actual = time.localtime()formato_personalizado = time.strftime("%d/%m/%Y %H:%M:%S", tiempo_actual)print(f"Formato personalizado: {formato_personalizado}") Códigos de Formato comunes en time.strftime() :
%Y: Año con cuatro dígitos (ej: 2024)%m: Mes (01-12)%d: Día del mes (01-31)%H: Hora (00-23)%M: Minutos (00-59)%S: Segundos (00-61)
time.strptime() : Análisis de Cadenas de Tiempo
Esta función realiza la operación inversa a time.strftime(). Toma una cadena de texto que representa una fecha y hora, junto con un formato, y retorna una tupla struct_time.

import timecadena_tiempo = "15/01/2024 10:30:00"formato = "%d/%m/%Y %H:%M:%S"tiempo_estructurado = time.strptime(cadena_tiempo, formato)print(f"Tiempo estructurado: {tiempo_estructurado}")Tabla Comparativa de Funciones
| Función | Descripción | Entrada | Salida |
|---|---|---|---|
time.time() | Segundos desde la época | Ninguna | Float |
time.ctime() | Fecha y hora legible | Segundos desde la época | String |
time.sleep() | Pausa la ejecución | Segundos | Ninguna |
time.localtime() | Estructura de tiempo local | Segundos desde la época (opcional) | struct_time |
time.gmtime() | Estructura de tiempo UTC | Segundos desde la época (opcional) | struct_time |
time.mktime() | Segundos desde la época | struct_time | Float |
time.asctime() | Fecha y hora legible | struct_time | String |
time.strftime() | Formato de fecha y hora personalizado | struct_time, formato | String |
time.strptime() | Análisis de cadena de tiempo | String, formato | struct_time |
Consultas Frecuentes
¿Cómo esperar 5 minutos en Python?
Utilizando time.sleep(300), ya que 5 minutos son 300 segundos (5 60).
import timeprint("Comenzando...")time.sleep(300)print("5 minutos han pasado.")¿Cuál es la mejor librería de tiempo en Python?
La librería time es la opción estándar y generalmente suficiente para la mayoría de las tareas relacionadas con el tiempo en Python. Para tareas más complejas o que requieren mayor precisión, se pueden considerar librerías adicionales como datetime.
¿Está time.time() en segundos?
Sí, time.time() retorna el tiempo en segundos desde la época, como un número de punto flotante.
Conclusión
La librería timeen Python proporciona un conjunto completo de funciones para la manipulación del tiempo. Su versatilidad la convierte en una herramienta indispensable para una amplia gama de aplicaciones, desde la creación de simples temporizadores hasta el manejo de eventos cronológicos complejos. La comprensión de sus funciones y la práctica con los ejemplos proporcionados permitirá a los desarrolladores aprovechar al máximo su potencial.
Si quieres conocer otros artículos parecidos a Librería time en python con ejemplos puedes visitar la categoría Libros y Librerías.
