Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Assegnare un offset UTC con datetime.replace()

Assegna un offset fisso e noto rispetto a UTC senza cambiare la data o l’ora indicata, poi ottieni una stringa in un formato personalizzato o in formato ISO 8601.

Versione: Python 3.12

Sintassi

dt.replace(year=dt.year, month=dt.month, day=dt.day, hour=dt.hour, minute=dt.minute, second=dt.second, microsecond=dt.microsecond, tzinfo=dt.tzinfo, fold=dt.fold)
aware = dt.replace(tzinfo=timezone(timedelta(hours=2)))
aware.strftime("%d/%m/%Y %H:%M:%S %z")
aware.isoformat()

In Python 3.12, datetime.datetime.replace è un metodo di istanza della classe datetime del modulo datetime. Restituisce un nuovo oggetto con i campi specificati sostituiti e quelli omessi copiati dall’originale. Non è un’operazione aritmetica sul tempo: per esempio, hour=24 solleva ValueError anziché passare al giorno successivo.

Se sai che l’ora registrata corrisponde all’offset +02:00, crea tz = timezone(timedelta(hours=2)) e chiama dt.replace(tzinfo=tz). Un oggetto privo di informazioni sul fuso orario (naive) le acquisisce (aware), ma la data e l’ora indicate restano uguali. Un offset fisso non tiene conto dei passaggi all’ora legale o solare. dt.replace(tzinfo=None) rimuove le informazioni sul fuso senza convertire la data o l’ora.

Per rappresentare lo stesso istante in un altro fuso, chiama astimezone(tz) su un oggetto che ha già informazioni sul fuso: la data o l’ora può cambiare, ma l’istante resta lo stesso. Con un oggetto naive, astimezone() presume il fuso locale del sistema. L’argomento fold si può passare solo per nome. In un intervallo di ora locale che si ripete, 0 seleziona il primo istante e 1 il secondo. Se ometti fold, il suo valore originale viene conservato.

strftime() segue una stringa di formato esplicita; qui %z produce +0200. L’insieme completo delle direttive supportate dipende dalla piattaforma. Senza argomenti, isoformat() restituisce una stringa ISO 8601 con il separatore T e l’offset +02:00. Nessuno dei due metodi modifica l’oggetto o converte l’ora.

Esempi

from datetime import datetime, timedelta, timezone

wall_time = datetime(2024, 6, 15, 9, 30)
fixed_offset = timezone(timedelta(hours=2))
aware = wall_time.replace(tzinfo=fixed_offset)

print(aware.strftime("%d/%m/%Y %H:%M:%S %z"))
print(aware.isoformat())

Risultato

15/06/2024 09:30:00 +0200
2024-06-15T09:30:00+02:00

Entrambe le righe mantengono `09:30:00`. Il formato personalizzato mette il giorno prima del mese e scrive `+0200`; il formato ISO 8601 scrive `+02:00`.

Lezioni correlate

  • Python · Lezione 31 · Intermedio · Versione: 3

Fonti