Vai al contenuto principale

Python datetime: come lavorare con date e orari in Python

Scopri i diversi modi per lavorare con gli strumenti datetime di Python e semplificare tutto, dal parsing delle stringhe alla gestione dei timestamp con fuso orario.
· 2 min leggi

Scopri con l'IA

Lavorare con date e orari sembra semplice finché non inizi a occuparti di formati, fusi orari, regole dell’ora legale o timestamp provenienti da sistemi diversi: a quel punto non è più un’opzione salvare l’ora come semplici stringhe o interi. Il modulo datetime di Python esiste proprio per aiutarti a gestire tutte queste variabili in modo prevedibile.

Questa guida illustra le classi principali, come creare e usare gli oggetti datetime, come eseguire operazioni aritmetiche, formattare e analizzare i valori, gestire i fusi orari e altro ancora. Ogni sezione si basa sulla precedente, così puoi passare dalle operazioni di base a schemi più avanzati.

Classi principali del modulo datetime di Python

Prima di fare qualcosa di specifico, è utile capire come Python modella date e orari a livello concettuale. Il modulo datetime utilizza un piccolo set di classi, ognuna focalizzata su una parte del problema. Sapere dove si colloca ciascuna classe rende il resto del flusso di lavoro molto più semplice.

date

Quando ti serve solo una data di calendario senza preoccuparti dell’ora del giorno o dei fusi orari, la classe date è quello che ti serve. Rappresenta anno, mese e giorno tramite attributi familiari.

Ecco gli attributi:

  • year

  • month

  • day

E i metodi:

  • today()

  • fromisoformat()

  • replace()

  • isoformat()

  • weekday()

  • isoweekday()

from datetime import date
d = date(2025, 3, 1)
print(d)

Questo codice crea una semplice data di calendario. Se inserisci una combinazione non valida (come February 30), Python genera un ValueError.

time

Alcuni compiti riguardano solo l’ora del giorno, ad esempio un promemoria che scatta alle 14:30. La classe time è utile perché memorizza ore, minuti, secondi e, se serve (non in questo esempio), microsecondi o informazioni sul fuso orario.

Gli attributi sono: hour, minute, second, microsecond, tzinfo

I metodi sono: replace(), isoformat()

from datetime import time
t = time(14, 30, 15)
print(t)

Questo crea un orario senza una data associata. Valori non validi (come hour=27) genereranno un errore.

datetime

La maggior parte dei casi reali combina sia data sia ora, ed è qui che entra in gioco datetime. È la classe più versatile del modulo e quella che userai più spesso per registrazione, elaborazione e coordinamento degli eventi.

Gli attributi sono (in aggiunta a tutti quelli sopra): tzinfo

E i metodi sono now(), utcnow(), fromisoformat(), strptime(), strftime(), astimezone(). Supporta anche l’aritmetica con timedelta, che tratterò più nel dettaglio.

from datetime import datetime
dt = datetime(2025, 3, 1, 14, 30)
print(dt)