HOWTO · Python

Funzioni timer in Python

Questo tutorial mostra come monitorare e analizzare il tempo di esecuzione di un codice Python

In questa pagina

Per la maggior parte delle misurazioni di durata trascorsa, usa time.perf_counter(); scegli time.process_time() quando ti interessa specificamente il tempo CPU utilizzato dal processo corrente. Il modulo time offre anche time.time() per ottenere timestamp basati sull’orologio di sistema e time.monotonic() per misurare intervalli che non devono risentire delle regolazioni dell’orologio di sistema. In ciascuno schema di misurazione, registra una lettura iniziale, esegui il lavoro, registra una lettura finale e sottrai la prima dalla seconda. Gli esempi qui sotto sono illustrativi: le durate misurate dipendono dalla macchina e dall’esecuzione.

Misurare l’ora di sistema con time.time()

time.time() restituisce l’ora corrente dell’orologio di sistema, in secondi dall’epoca Unix, ovvero dalle 00:00:00 UTC del 1º gennaio 1970. Usala quando ti serve un timestamp da memorizzare, visualizzare o confrontare con un altro timestamp. Poiché segue l’orologio di sistema, una regolazione effettuata dal sistema operativo o dall’utente può modificarne la lettura. Per questo non è la scelta predefinita migliore per misurare intervalli brevi: una regolazione dell’orologio tra le due letture può alterare il risultato della sottrazione.

Esegui questo esempio:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

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 prima riga mostra la somma deterministica; la seconda è una durata misurata e varierà. Mantieni il codice da misurare tra le due letture, così la sottrazione copre il lavoro desiderato.

Misurare il tempo CPU con time.process_time()

time.process_time() misura il tempo CPU consumato dal processo corrente. Il valore non include il tempo trascorso in attesa o durante il sonno, né quello impiegato per aspettare un input, una risposta di rete o un altro processo. Usala per stimare quanto tempo di elaborazione consuma il tuo codice, anziché quanto deve attendere l’utente prima che termini. Sottraendo la lettura iniziale da quella finale ottieni il tempo CPU impiegato dal lavoro svolto nel frattempo.

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

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")

Se un’attività trascorre molto tempo in attesa, il suo tempo CPU può essere molto inferiore alla durata trascorsa. Questa differenza è utile per distinguere il calcolo dall’attesa, ma da sola non indica che cosa stesse aspettando il processo.

Misurare il tempo trascorso con time.perf_counter()

time.perf_counter() è un orologio monotono ad alta risoluzione, pensato per misurare intervalli di tempo trascorso. Il suo punto di riferimento non è specificato: usa quindi la differenza tra le letture, senza interpretare un singolo valore come una data o un timestamp. A differenza del tempo CPU del processo, il tempo trascorso include anche quello impiegato dormendo o in attesa. È adatto sia a funzioni brevi sia a operazioni più lunghe; la sua precisione non ne limita l’uso ai processi di piccole dimensioni.

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

import time

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

Il risultato sarà vicino alla durata di sospensione richiesta, ma la pianificazione del sistema e il carico possono aggiungere altro tempo. Per confrontare le prestazioni, ripeti attività comparabili e confronta le misurazioni in condizioni simili, senza considerare una singola lettura una garanzia.

Misurare il tempo trascorso con time.monotonic()

Anche time.monotonic() misura intervalli di tempo trascorso, usando un orologio che non può tornare indietro a causa degli aggiornamenti dell’orologio di sistema. Il suo punto di riferimento non è definito, quindi solo le differenze tra le letture sono significative. Usala per le scadenze dei timeout o per controllare la durata trascorsa quando le variazioni dell’orologio civile non devono influire sul calcolo. Le sue letture non si adattano ai cambiamenti dell’orologio esterno: li evitano nella misurazione degli intervalli.

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

import time

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

Scegli time.time() quando ti serve un timestamp Unix, time.process_time() per misurare il tempo CPU consumato dal processo e time.perf_counter() per le misurazioni generali del tempo trascorso. Scegli time.monotonic() quando un intervallo o un timeout deve restare affidabile anche se cambia l’orologio di sistema. In tutti i casi, è il codice eseguito tra le due letture a determinare quale durata viene misurata.