Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

timeit.timeit

timeit mide la duración total de number ejecuciones de una instrucción o una función sin argumentos.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)

timeit mide la duración total de number ejecuciones de una instrucción o una función sin argumentos.

En la API, number vale 1_000_000 por defecto, mientras que python -m timeit sin -n elige automáticamente el número de repeticiones. setup puede activar el recolector con gc.enable(). Si la medición desactivó un recolector antes activo, lo reactiva aunque la instrucción lance una excepción. El reloj predeterminado perf_counter da segundos. Si number es positivo, dividir por number da la media por ejecución. setup queda fuera de la medición. Por defecto se desactiva temporalmente la recolección de ciclos.

El ejemplo añade cuatro elementos y comprueba que el tiempo no sea negativo.

import timeit,gc
ticks=iter([1.,3.])
steps=[]
elapsed=timeit.timeit(lambda: steps.append(gc.isenabled()), lambda: steps.append('setup'), timer=lambda:next(ticks),number=3)
assert elapsed==2. and steps==['setup',False,False,False]
old=gc.isenabled()
try:
    gc.enable()
    def fail():
        assert not gc.isenabled()
        raise ValueError('timed')
    try: timeit.timeit(fail,number=1)
    except ValueError: pass
    else: raise AssertionError
    assert gc.isenabled()
    seen=[]
    timeit.timeit(lambda:seen.append(gc.isenabled()), setup=gc.enable,number=1)
    assert seen==[True]
finally:
    if not old: gc.disable()

Ejemplos

import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)

Resultado

4 True

El ejemplo añade cuatro elementos y comprueba que el tiempo no sea negativo.

Fuentes