time

Mettre le programme en pause, horodatages et mesure précise du temps d’exécution du code.

Sur cette page

Exemple

#
Python
import time

for seconds in range(3, 0, -1):
    print(f"Départ dans {seconds}...")
    time.sleep(1)

print("Partez !")
Résultatrésultat enregistré, vous pouvez le vérifier
Départ dans 3...
Départ dans 2...
Départ dans 1...
Partez !

Les lignes apparaissent à une seconde d’intervalle.

Définition et utilisation

#

Le module time fournit les fonctions de base liées au temps. time.sleep(secondes) met le programme en pause pendant la durée indiquée, time.time() renvoie le nombre de secondes écoulées depuis le 1er janvier 1970 (ce qu’on appelle l’horodatage Unix), et time.perf_counter() sert à mesurer précisément la durée d’un fragment de code.

Pour les mesures, choisissez perf_counter() plutôt que time(). L’horloge système peut être modifiée, par exemple lors d’une synchronisation avec internet, alors que perf_counter() ne fait que croître et a une grande précision. Seule la différence entre deux relevés compte.

Les fonctions gmtime(), localtime() et strftime() transforment un horodatage en date et en texte. Pour les calculs sur les dates, comme ajouter des jours ou comparer des échéances, le module datetime est plus pratique.

Syntaxe

#
Syntaxe
import time

time.sleep(secondes)
time.time()
time.perf_counter()
time.strftime(format, struct_time)

Plus d’exemples

#
Mesurer le temps d’exécution
Python
import time

start = time.perf_counter()
total = sum(n * n for n in range(1_000_000))
elapsed = time.perf_counter() - start

print(total)
print(f"Le calcul a duré {elapsed:.3f} s")
Résultat
Cliquez sur Exécuter pour voir le résultat.

La première ligne est toujours 333332833333500000. Le temps mesuré dépend de l’ordinateur, par exemple Le calcul a duré 0.041 s.

Un horodatage converti en date
Python
import time

moment = time.gmtime(1_790_000_000)
print(moment.tm_year, moment.tm_mon, moment.tm_mday)
print(time.strftime("%Y-%m-%d %H:%M:%S", moment))
Résultatrésultat enregistré, vous pouvez le vérifier
2026 9 21
2026-09-21 14:13:20

gmtime() donne l’heure UTC. L’heure locale est renvoyée par localtime(), et l’horodatage actuel par time.time().

Bonnes pratiques

#
  • Mesurez le temps d’exécution du code avec time.perf_counter(). Pour comparer les performances de courts fragments, il existe aussi le module timeit.
  • Dans les programmes asynchrones, n’utilisez pas time.sleep(), car il bloque toute la boucle d’événements. Écrivez plutôt await asyncio.sleep().

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.