datetime: date e orari

Il modulo datetime fornisce le classi per rappresentare date e orari.

Le tre classi principali

• date — solo data (anno, mese, giorno)
• time — solo orario (ora, minuto, secondo, microsecondo)
• datetime — data + orario insieme
• timedelta — una durata (differenza tra due istanti)

from datetime import date, time, datetime, timedelta

date(2025, 1, 1)                  # datetime.date(2025, 1, 1)
time(14, 30, 0)                   # datetime.time(14, 30)
datetime(2025, 1, 1, 14, 30, 0)   # datetime.datetime(2025, 1, 1, 14, 30)

"Adesso": now e today

datetime.now()        # data + ora correnti
date.today()          # solo data corrente

Aritmetica con timedelta

from datetime import datetime, timedelta

ora = datetime(2025, 1, 1, 12, 0)
domani = ora + timedelta(days=1)
una_ora_fa = ora - timedelta(hours=1)

# differenza fra due datetime → timedelta
delta = domani - ora
delta.days        # 1
delta.total_seconds()   # 86400.0

timedelta accetta days, seconds, microseconds, milliseconds, minutes, hours, weeks (NON months o years, ambigui).

Formatting: strftime

Trasforma datetime → stringa secondo un pattern.

ora = datetime(2025, 1, 1, 14, 30)
ora.strftime("%Y-%m-%d")         # '2025-01-01'
ora.strftime("%d/%m/%Y %H:%M")   # '01/01/2025 14:30'
ora.strftime("%A %d %B %Y")      # 'Wednesday 01 January 2025' (dipende dal locale)

Direttive più usate: %Y anno 4cifre, %m mese 2cifre, %d giorno 2cifre, %H ora 24h, %M minuti, %S secondi.

Parsing: strptime

L'opposto: stringa → datetime, indicando il pattern atteso.

datetime.strptime("01/01/2025", "%d/%m/%Y")
# datetime.datetime(2025, 1, 1, 0, 0)

ISO 8601

Per scambio di dati preferisci sempre il formato ISO 8601 (YYYY-MM-DDTHH:MM:SS):

ora.isoformat()                 # '2025-01-01T14:30:00'
datetime.fromisoformat("2025-01-01T14:30:00")

Fusi orari e datetime aware

Per impostazione predefinita, gli oggetti datetime in Python sono naive (non contengono informazioni sul fuso orario). Per applicazioni reali, è raccomandato renderli aware impostando il fuso orario tramite timezone.utc del modulo datetime, o usando moduli esterni come zoneinfo.

Prova tu

Esercizio di ripasso

Sfida aggiuntiva