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.
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)Offerto da
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)Offerto da
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)
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
datetimedi 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
datetimeutilizza 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:
yearmonthdayE i metodi:
today()fromisoformat()replace()isoformat()weekday()isoweekday()Questo codice crea una semplice data di calendario. Se inserisci una combinazione non valida (come
February 30), Python genera unValueError.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,tzinfoI metodi sono:
replace(),isoformat()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):
tzinfoE i metodi sono
now(),utcnow(),fromisoformat(),strptime(),strftime(),astimezone(). Supporta anche l’aritmetica contimedelta, che tratterò più nel dettaglio.