Python Academy · Lezione

Fusi orari con zoneinfo

Lavorare con datetime consapevoli del fuso orario

Fusi orari con zoneinfo è una lezione Python Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Python Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Python Academy include 4 lezioni in totale.

datetime naive e aware

Un datetime naive non contiene informazioni sul fuso orario: indica semplicemente «le 14», senza specificare quali siano. Un datetime aware include un fuso orario, quindi identifica un istante preciso in tutto il mondo.

I datetime aware prevengono gli errori quando gli utenti si trovano in regioni diverse.

from datetime import datetime
naive = datetime(2026, 5, 30, 14, 0)
print(naive.tzinfo)

Importare zoneinfo

Python 3.9 e le versioni successive includono zoneinfo nella libreria standard. Importi ZoneInfo e passi un nome di fuso orario IANA come 'Europe/Istanbul' o 'America/New_York'.

from zoneinfo import ZoneInfo
tz = ZoneInfo('Europe/Istanbul')
print(tz)

Creare un datetime aware

Passi tzinfo=ZoneInfo(...) quando costruisce un datetime per renderlo aware. A questo punto sa esattamente a quale regione appartiene.

from datetime import datetime
from zoneinfo import ZoneInfo
d = datetime(2026, 5, 30, 14, 0, tzinfo=ZoneInfo('Europe/Istanbul'))
print(d)
print(d.tzinfo)

UTC come riferimento

UTC è il riferimento universale. Usi datetime.now(ZoneInfo('UTC')) per ottenere l'ora UTC aware corrente. La pratica consigliata è memorizzare gli orari in UTC.

from datetime import datetime
from zoneinfo import ZoneInfo
utc_now = datetime(2026, 5, 30, 11, 0, tzinfo=ZoneInfo('UTC'))
print(utc_now)

Convertire tra fusi orari

.astimezone(tz) converte un datetime aware in un altro fuso orario, regolando l'orologio affinché continui a indicare lo stesso istante.

from datetime import datetime
from zoneinfo import ZoneInfo
utc = datetime(2026, 5, 30, 11, 0, tzinfo=ZoneInfo('UTC'))
ist = utc.astimezone(ZoneInfo('Europe/Istanbul'))
print('UTC:', utc)
print('Istanbul:', ist)

Stesso istante, orologi diversi

Dopo la conversione, i valori dell'orologio civile differiscono, ma l'istante sottostante è identico. Il confronto tra due datetime aware confronta gli istanti reali, non le cifre visualizzate.

from datetime import datetime
from zoneinfo import ZoneInfo
utc = datetime(2026, 5, 30, 11, 0, tzinfo=ZoneInfo('UTC'))
ny = utc.astimezone(ZoneInfo('America/New_York'))
print(utc == ny)

Leggere l'offset UTC

Il metodo .utcoffset() restituisce un timedelta che indica di quanto il fuso si discosta da UTC in quell'istante, includendo anche eventuali variazioni dovute all'ora legale.

from datetime import datetime
from zoneinfo import ZoneInfo
d = datetime(2026, 5, 30, 14, 0, tzinfo=ZoneInfo('Europe/Istanbul'))
print('Offset:', d.utcoffset())

Ora legale gestita automaticamente

zoneinfo utilizza il database dei fusi orari del sistema, quindi sa quando inizia e finisce l'ora legale. Lo stesso fuso può avere offset diversi durante l'anno.

from datetime import datetime
from zoneinfo import ZoneInfo
winter = datetime(2026, 1, 15, 12, 0, tzinfo=ZoneInfo('America/New_York'))
summer = datetime(2026, 7, 15, 12, 0, tzinfo=ZoneInfo('America/New_York'))
print('Winter:', winter.utcoffset())
print('Summer:', summer.utcoffset())

Associare un fuso a un'ora naive

Se un datetime naive rappresenta un'ora locale nota, associ un fuso con .replace(tzinfo=...). In questo modo lo etichetta senza spostare l'ora.

from datetime import datetime
from zoneinfo import ZoneInfo
naive = datetime(2026, 5, 30, 9, 0)
aware = naive.replace(tzinfo=ZoneInfo('Europe/Istanbul'))
print(aware)

Evitare di mescolare naive e aware

Non può sottrarre né confrontare un datetime naive con uno aware: Python solleva un TypeError. Mantenga coerenti i datetime in tutto il programma.

from datetime import datetime
from zoneinfo import ZoneInfo
naive = datetime(2026, 5, 30, 9, 0)
aware = datetime(2026, 5, 30, 9, 0, tzinfo=ZoneInfo('UTC'))
try:
    print(aware - naive)
except TypeError as e:
    print('Error:', e)

Formattare con il fuso orario

Il codice %Z stampa il nome del fuso orario e %z stampa l'offset numerico quando formatta un datetime aware.

from datetime import datetime
from zoneinfo import ZoneInfo
d = datetime(2026, 5, 30, 14, 0, tzinfo=ZoneInfo('Europe/Istanbul'))
print(d.strftime('%Y-%m-%d %H:%M %Z %z'))

Verifica rapida

Qual è la differenza fondamentale tra un datetime naive e uno aware?

Riepilogo: fusi orari con zoneinfo

Riepilogo:

I datetime naive non contengono informazioni sul fuso orario; quelli aware includono tzinfo.
Usi ZoneInfo('Region/City') dal modulo zoneinfo.
.astimezone() converte un datetime aware in un altro fuso.
zoneinfo gestisce automaticamente l'ora legale; non mescoli mai datetime naive e aware.

from datetime import datetime
from zoneinfo import ZoneInfo
utc = datetime(2026, 5, 30, 12, 0, tzinfo=ZoneInfo('UTC'))
print(utc.astimezone(ZoneInfo('Europe/Istanbul')))

Domande Frequenti

La lezione «Fusi orari con zoneinfo» è gratuita?

Sì — il testo completo di «Fusi orari con zoneinfo» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Python Academy, passa a CoddyKit PRO. Il corso Python Academy include 4 lezioni in totale.

Cosa imparerò in «Fusi orari con zoneinfo»?

Lavorare con datetime consapevoli del fuso orario Eserciti Python Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Python Academy?

Non è richiesta alcuna esperienza precedente. Python Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Fusi orari con zoneinfo»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Python Academy?

Sì. Ogni lezione Python Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Python Academy