Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Python `date`: leggere una data, estrarla e combinarla con un orario

In Python 3.12, `strptime()` restituisce un `datetime`, `.date()` estrae la data e `combine()` la unisce a un orario scelto.

Versione: Python 3.12

Sintassi

from datetime import date, datetime, time

calendar_day = date(year, month, day)
parsed = datetime.strptime(text, format_string)
calendar_day = parsed.date()
combined = datetime.combine(calendar_day, clock_time)
combined = datetime.combine(calendar_day, clock_time, tzinfo=zone)

In Python 3.12, datetime.date è una classe immutabile del modulo datetime. Un oggetto date contiene anno, mese e giorno, ma non un orario né un fuso orario. Dopo from datetime import date, date(year, month, day) costruisce una data a partire da tre interi. Se gli argomenti sono rappresentabili con il tipo int del C, una data non valida come il 29 febbraio 2023 causa ValueError. In CPython 3.12, un intero che non può essere convertito in un int del C, come l’anno in date(10**100, 1, 1), causa OverflowError prima della convalida della data.

Dopo from datetime import datetime, il nome datetime indica la classe datetime.datetime, non il modulo. Il metodo di classe datetime.strptime(text, format_string) interpreta il testo secondo il formato indicato e restituisce un datetime, anche se il testo contiene solo una data. In %d/%m/%Y, le barre separano giorno, mese e anno a quattro cifre. Se non si specifica l’orario, il risultato ha orario 00:00:00. Un testo non conforme al formato o una data non valida causano ValueError. In Python 3.12 la classe date non ha un metodo strptime().

Il metodo di istanza parsed.date() restituisce un date con lo stesso anno, mese e giorno. Non modifica parsed, non conserva l’orario né il fuso orario e non esegue conversioni tra fusi orari. Diversamente da questo metodo, il costruttore date(year, month, day) riceve le componenti della data separatamente.

Il metodo di classe datetime.combine(calendar_day, clock_time) crea un nuovo datetime a partire da una data e da un oggetto datetime.time, non da una stringa. Per impostazione predefinita prende tzinfo dall’oggetto time; un argomento esplicito tzinfo=zone sostituisce quel valore senza convertire l’orario. Se il primo argomento è un datetime, il suo orario e il suo tzinfo vengono ignorati.

Esempi

from datetime import date, datetime, time

parsed = datetime.strptime("29/02/2024", "%d/%m/%Y")
calendar_day = parsed.date()
assert type(calendar_day) is date
combined = datetime.combine(calendar_day, time(14, 30))

print(parsed.isoformat())
print(calendar_day.isoformat())
print(combined.isoformat())

Risultato

2024-02-29T00:00:00
2024-02-29
2024-02-29T14:30:00

La prima riga mostra la mezzanotte dopo la lettura di una data senza orario, la seconda mostra solo la data e la terza mostra la stessa data alle 14:30 senza fuso orario.

Lezioni correlate

  • Python · Lezione 31 · Intermedio · Versione: 3

Fonti