HOWTO · Python

Funciones de temporizador en Python

Este tutorial demuestra cómo monitorear y analizar el tiempo de ejecución de un código Python

En esta página

Usa time.perf_counter() para la mayoría de las mediciones de tiempo transcurrido y elige time.process_time() cuando quieras medir específicamente el tiempo de CPU consumido por el proceso actual. El módulo time también ofrece time.time() para obtener marcas de tiempo del reloj del sistema y time.monotonic() para medir intervalos que no deben verse afectados por ajustes del reloj del sistema. En cada patrón de medición, registra una lectura inicial, ejecuta el trabajo, registra una lectura final y resta la lectura inicial de la final. Los fragmentos de código que aparecen a continuación son ilustrativos; las duraciones medidas dependen del equipo y de cada ejecución.

Medir el tiempo de reloj con time.time()

time.time() devuelve la hora actual del reloj del sistema en segundos desde la época Unix: las 00:00:00 UTC del 1 de enero de 1970. Úsala cuando necesites una marca de tiempo que puedas almacenar, mostrar o comparar con otra. Como sigue el reloj del sistema, un ajuste realizado por el sistema operativo o por el usuario puede cambiar su lectura. Por eso no es la opción predeterminada más adecuada para medir intervalos cortos: un ajuste entre las dos lecturas puede distorsionar la resta.

Ejecuta este ejemplo:

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

import time

start = time.time()
total = sum(range(1, 1001))
end = time.time()

print(f"sum={total}")
print(f"elapsed={end - start:.6f} seconds")

La primera línea muestra la suma determinista; la segunda, una duración medida que variará. Coloca el código que quieras medir entre las dos lecturas para que la resta abarque el trabajo previsto.

Medir el tiempo de CPU con time.process_time()

time.process_time() mide el tiempo de CPU consumido por el proceso actual. Su valor no incluye el tiempo que se pasa durmiendo o esperando una entrada, una respuesta de red u otro proceso. Úsala para estimar cuánto tiempo de procesador consume tu código, en lugar de medir cuánto espera el usuario a que termine. Al restar la lectura inicial de la final, obtienes la duración de CPU del trabajo realizado entre ambas.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

import time

start = time.process_time()
total = sum(number * number for number in range(100_000))
cpu_seconds = time.process_time() - start
print(f"sum={total}; CPU time={cpu_seconds:.6f} seconds")

Si una tarea pasa mucho tiempo esperando, su duración de CPU puede ser mucho menor que su duración transcurrida. Esa diferencia resulta útil para distinguir el cálculo de la espera, pero por sí sola no indica qué estaba esperando el proceso.

Medir el tiempo transcurrido con time.perf_counter()

time.perf_counter() es un reloj monótono de alta resolución diseñado para medir intervalos de tiempo transcurrido. Su origen no está definido, así que usa las diferencias entre lecturas en vez de interpretar un valor individual como una fecha o una marca de tiempo. A diferencia del tiempo de CPU del proceso, el tiempo transcurrido incluye el que se pasa durmiendo o esperando. Sirve tanto para funciones breves como para operaciones más largas; su precisión no significa que deba limitarse a procesos pequeños.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

import time

start = time.perf_counter()
time.sleep(0.1)
elapsed = time.perf_counter() - start
print(f"elapsed={elapsed:.3f} seconds")

El resultado será aproximadamente la duración solicitada para la pausa, aunque la planificación del sistema y su carga pueden añadir tiempo. Para hacer pruebas de rendimiento, repite trabajos comparables y compara las mediciones en condiciones similares; no trates una sola lectura como un resultado garantizado.

Medir el tiempo transcurrido con time.monotonic()

time.monotonic() también mide intervalos de tiempo transcurrido, mediante un reloj que no puede retroceder debido a ajustes del reloj del sistema. Su punto de referencia no está definido, así que solo tienen significado las diferencias entre lecturas. Úsala para plazos de espera o comprobaciones de duración cuando los cambios del reloj de pared no deban afectar al cálculo. Sus lecturas no se adaptan a cambios externos del reloj; los evitan al medir intervalos.

El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.

import time

start = time.monotonic()
time.sleep(0.1)
elapsed = time.monotonic() - start
print(f"elapsed={elapsed:.3f} seconds")

Elige time.time() cuando necesites una marca de tiempo Unix, time.process_time() para medir el tiempo de CPU consumido por el proceso y time.perf_counter() para mediciones generales de tiempo transcurrido. Elige time.monotonic() cuando un intervalo o plazo de espera deba seguir siendo fiable aunque cambie el reloj del sistema. En todos los casos, el código situado entre las dos lecturas determina qué abarca la duración medida.