datetime in Python: date, orari, timedelta e fusi orari

I due tipi fondamentali: date e datetime

Il modulo datetime ti offre quattro cose da conoscere: date, time, datetime e timedelta. I primi tre sono quello che sembrano; il quarto è un intervallo di tempo.

from datetime import date, datetime, timedelta

today = date.today()
now = datetime.now()

print(today)
print(now)
print(type(today), type(now))

Un date rappresenta un giorno (anno, mese, giorno) senza orologio. Un datetime è una data più un orario. Se l'orario non ti serve, date è la scelta più ordinata.

Creare date specifiche

Costruiscile direttamente:

from datetime import date, datetime

launch = date(2026, 1, 15)
meeting = datetime(2026, 1, 15, 14, 30)

print(launch)
print(meeting)

Gli argomenti sono year, month, day per date, e fino a year, month, day, hour, minute, second, microsecond per datetime.

Leggere i campi

Ogni date/datetime ha degli attributi:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30, 15)

print(now.year, now.month, now.day)
print(now.hour, now.minute, now.second)
print(now.weekday())        # 0 = Monday, 6 = Sunday
print(now.isoweekday())     # 1 = Monday, 7 = Sunday
print(now.isoformat())

isoformat() è il tuo alleato per un output leggibile dalle macchine: produce qualcosa come "2026-04-20T09:30:15", che altri sistemi possono interpretare senza ambiguità.

Formattare con strftime

Per un output leggibile dalle persone, .strftime(fmt) trasforma un date o un datetime in una stringa formattata:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30)

print(now.strftime("%Y-%m-%d"))          # 2026-04-20
print(now.strftime("%d %B %Y"))          # 20 April 2026
print(now.strftime("%I:%M %p"))          # 09:30 AM
print(now.strftime("%A, %d %b"))         # Monday, 20 Apr

I codici di formato che conviene ricordare più spesso:

• %Y: anno a 4 cifre (2026)
• %m: numero del mese, con zero iniziale (04)
• %d: giorno del mese, con zero iniziale (20)
• %H / %I: ora, formato 24 o 12 ore
• %M: minuti
• %S: secondi
• %A / %a: nome del giorno completo o abbreviato (Monday / Mon)
• %B / %b: nome del mese completo o abbreviato (April / Apr)
• %p: AM/PM

Non serve impararli a memoria; salva un riferimento tra i preferiti e consultalo quando ti serve.

Interpretare con strptime

La direzione opposta: prendere una stringa di forma nota e trasformarla in un datetime:

from datetime import datetime

text = "2026-04-20 09:30"
parsed = datetime.strptime(text, "%Y-%m-%d %H:%M")

print(parsed)
print(parsed.year, parsed.hour)

La stringa di formato deve corrispondere esattamente all'input. Se non corrisponde, strptime solleva ValueError.

Per le stringhe ISO-8601 (lo standard leggibile dalle macchine), nel Python moderno c'è una scorciatoia più semplice:

from datetime import datetime

d = datetime.fromisoformat("2026-04-20T09:30:00")
print(d)

Se hai a che fare con formati casuali, il pacchetto esterno dateutil (pip install python-dateutil) ha un parser.parse() tollerante che prova a indovinare in modo ragionevole.

Calcoli con timedelta

Per fare calcoli con le date, usa timedelta per la differenza o lo spostamento:

from datetime import date, datetime, timedelta

today = date(2026, 4, 20)
next_week = today + timedelta(days=7)
yesterday = today - timedelta(days=1)

print(next_week, yesterday)

# Sottrarre due date ti dà un timedelta.
gap = date(2027, 1, 1) - today
print(gap)
print(gap.days)

Argomenti di timedelta: days, seconds, microseconds, milliseconds, minutes, hours, weeks. Niente months né years: i mesi hanno lunghezza variabile. Per i calcoli con mesi e anni, usa dateutil.relativedelta:

from dateutil.relativedelta import relativedelta
from datetime import date

today = date.today()
next_quarter = today + relativedelta(months=3)
print(next_quarter)

Fusi orari: naive e aware

Un datetime senza informazioni sul fuso orario è naive: Python non sa quale fuso rappresenti. I calcoli con datetime naive vanno bene finché resti in un unico fuso logico; i problemi iniziano appena si incontrano dati da fusi diversi.

Un datetime aware porta con sé le informazioni sul fuso. Aggiungi un fuso esplicitamente:

from datetime import datetime, timezone, timedelta

utc_now = datetime.now(timezone.utc)
print(utc_now)
print(utc_now.tzinfo)

Python 3.9 ha aggiunto il modulo zoneinfo per i fusi orari con nome (usa il database IANA del sistema):

from datetime import datetime
from zoneinfo import ZoneInfo

now_tokyo = datetime.now(ZoneInfo("Asia/Tokyo"))
now_ny = datetime.now(ZoneInfo("America/New_York"))

print(now_tokyo)
print(now_ny)
print(now_tokyo - now_ny)   # timedelta quasi zero: stesso istante, orologi diversi

Converti da un fuso all'altro con .astimezone():

from datetime import datetime
from zoneinfo import ZoneInfo

utc = datetime(2026, 4, 20, 12, 0, tzinfo=ZoneInfo("UTC"))
berlin = utc.astimezone(ZoneInfo("Europe/Berlin"))

print(utc)
print(berlin)

Una regola da tenere a mente: salva i datetime in UTC e converti nei fusi locali solo al momento di mostrarli. Questa sola abitudine previene la maggior parte dei bug legati ai fusi orari.

Timestamp

Un timestamp Unix è il numero di secondi trascorsi dal 1970-01-01 UTC. Python lo converte facilmente:

from datetime import datetime, timezone

now = datetime.now(timezone.utc)
ts = now.timestamp()

print(ts)
print(datetime.fromtimestamp(ts, tz=timezone.utc))

I timestamp sono utili per confronti, ordinamenti e per scambiare dati con altri sistemi. Per l'output destinato alle persone, riconvertili prima in datetime.

Misurare quanto dura qualcosa

Per misurazioni veloci, sottrai due datetime:

from datetime import datetime
import time

start = datetime.now()
time.sleep(0.2)
elapsed = datetime.now() - start

print(elapsed.total_seconds())

Per misure di prestazioni più serie, usa time.perf_counter(): ha una risoluzione inferiore al microsecondo e non risente dei cambi dell'orologio di sistema. datetime.now() va bene per numeri del tipo "quanto ci ha messo questa chiamata API".

Schemi che riutilizzerai

from datetime import date, datetime, timedelta, timezone

# Data di oggi in formato ISO
print(date.today().isoformat())

# Età in anni (approssimativa, non esatta con gli anni bisestili)
dob = date(1990, 7, 15)
days_old = (date.today() - dob).days
print(days_old // 365, "years old")

# Inizio dell'ora corrente in UTC
now = datetime.now(timezone.utc)
start_of_hour = now.replace(minute=0, second=0, microsecond=0)
print(start_of_hour)

# Sette giorni fa
print(date.today() - timedelta(days=7))

Cosa portarsi a casa

• date, datetime e timedelta coprono il 90% delle necessità.
• Usa ISO-8601 per l'output leggibile dalle macchine; strftime per quello leggibile dalle persone.
• Salva in UTC; converti al momento di mostrare.
• Usa zoneinfo per i fusi orari con nome.
• Per mesi e anni, ricorri a dateutil.relativedelta.

Un altro strumento per la tua cassetta degli attrezzi: le espressioni regolari, subito dopo.