Timestamp Unix et Epoch en Python

Le temps Unix compte le temps écoulé depuis l’époque Unix, le 1er janvier 1970 à 00:00:00 UTC. Les écosystèmes n’utilisent pas toujours la même unité : indiquez explicitement secondes, millisecondes, microsecondes ou nanosecondes.

Démarrage rapide#

L’exemple suivant utilise l’API standard de Python ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

1from datetime import datetime, timezone2import time34seconds = int(time.time())5milliseconds = time.time_ns() // 1_000_0006print(seconds, milliseconds)78dt = datetime.fromtimestamp(seconds, tz=timezone.utc)9print(dt.isoformat())

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

1dt = datetime(, , , , , tzinfo=timezone.utc)2seconds = int(dt.timestamp())3milliseconds = int(dt.timestamp() * )

Points importants#

Indiquez toujours l’unité du timestamp et utilisez UTC pour l’échange entre systèmes ; appliquez un fuseau nommé seulement lors de l’affichage ou des règles métier.

Bonnes pratiques#

1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

• POSIX Seconds Since the Epoch
• Python Documentation