Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Scostamento fisso da UTC e formattazione con `strftime` e `isoformat`

Associa uno scostamento fisso da UTC senza cambiare l’ora indicata dall’orologio, poi rappresenta lo stesso valore in un formato personalizzato e in formato ISO 8601.

Versione: Python 3.12

Sintassi

dt.replace(tzinfo=tz) -> datetime
dt.astimezone(tz) -> datetime
dt.strftime(format) -> str
dt.isoformat(sep='T', timespec='auto') -> str

In Python 3.12, dt.replace(tzinfo=tz) restituisce un nuovo oggetto datetime.datetime con tzinfo impostato, senza cambiare la data né l’ora indicata dall’orologio. Usa questo metodo quando sai che l’ora locale registrata corrisponde a quello scostamento. timezone(timedelta(...)) rappresenta uno scostamento fisso da UTC, non un fuso orario con regole per l’ora legale.

Associare uno scostamento non equivale a convertire l’ora. Su un datetime con informazioni sul fuso orario (in inglese aware), dt.astimezone(tz) conserva lo stesso istante e adatta, se necessario, data e ora al fuso di destinazione. Sostituire tzinfo con uno scostamento diverso lascia invariata l’ora indicata, ma cambia l’istante rappresentato.

dt.strftime(format) restituisce una stringa che segue lo schema fornito. Nell’esempio, %d/%m/%Y %H:%M:%S %z mette il giorno prima del mese, omette le frazioni di secondo e scrive lo scostamento come +0530. Per un oggetto privo di informazioni sul fuso orario (in inglese naive), %z produce una stringa vuota. Il supporto di alcune direttive varia a seconda della piattaforma e i nomi dei mesi dipendono dalle impostazioni locali.

dt.isoformat() restituisce la data e l’ora come stringa e aggiunge lo scostamento se utcoffset() non restituisce None. sep è il singolo carattere che separa la data dall’ora; il valore predefinito è 'T'. Il risultato non è sempre conforme a ISO 8601: sep può essere un carattere non ammesso dallo standard e, anche con il separatore predefinito, lo scostamento da UTC può contenere secondi o frazioni di secondo, che lo standard non ammette negli scostamenti. Con timespec='auto' si mostrano i secondi e si aggiungono sei cifre decimali solo se i microsecondi sono diversi da zero. Un’opzione più breve come timespec='milliseconds' tronca senza arrotondare; un timespec non valido solleva ValueError. Nessuno dei due metodi di formattazione modifica l’oggetto.

Esempi

from datetime import datetime, timedelta, timezone

wall_time = datetime(2025, 3, 29, 14, 5, 6, 987654)
fixed_offset = timezone(timedelta(hours=5, minutes=30))
annotated = wall_time.replace(tzinfo=fixed_offset)

print(annotated.strftime('%d/%m/%Y %H:%M:%S %z'))
print(annotated.isoformat(timespec='milliseconds'))

Risultato

29/03/2025 14:05:06 +0530
2025-03-29T14:05:06.987+05:30

Dopo aver associato `+05:30`, l’orologio segna ancora `14:05:06`. La prima riga usa il formato personalizzato con `+0530`; la seconda il formato ISO con `+05:30` e la frazione `.987`.

Lezioni correlate

  • Python · Lezione 31 · Intermedio · Versione: 3

Fonti