Python datetime: come lavorare con data e ora in Python

Il modulo Python datetime semplifica il lavoro con informazioni su data e ora. In questo modo è possibile visualizzare le date e creare oggetti data utilizzando soltanto poche righe di codice.

Il modulo datetime in breve

Python datetime è un modulo di Python che vale la pena conoscere, sia che abbiate appena letto il vostro primo tutorial su Python sia che lavoriate già da tempo con questo linguaggio di programmazione per il web. È possibile pensare ai moduli come a una libreria di codice in altri linguaggi di programmazione. L’importazione del modulo datetime permette di ampliare le funzionalità di Python con funzioni per la gestione della data e dell’ora. A tal fine, il modulo utilizza specifici oggetti data che potete creare facilmente nel vostro codice.

Python datetime: data e ora

Un esempio di utilizzo di Python datetime è la memorizzazione di data e ora in un oggetto separato. Per farlo è necessario il costruttore Python datetime, la cui sintassi si presenta così:

import datetime as dt
dt.datetime(year, month, day, hour, minute, second, microsecond, timezone)

I parametri accettati dalla funzione rappresentano la data e l’ora correnti. I parametri che specificano l’ora sono opzionali: il valore predefinito è sempre impostato su 0. Lo stesso vale per il parametro che indica il fuso orario e che è impostato su NULL per impostazione predefinita. La funzione datetime restituisce un oggetto datetime di Python.

Il costruttore date in Python: la data

Analogamente al costruttore datetime, Python dispone anche del costruttore date, che permette di creare un oggetto date. Qui l’ora corrente non ha alcuna importanza. La sintassi del costruttore date è analoga a quella di datetime:

import datetime as dt
dt.date(year, month, day)

I parametri di passaggio accettati dal costruttore date in Python sono l’anno, il mese e il giorno desiderati. Il risultato dell’esecuzione della funzione è un oggetto date.

Come richiamare la data corrente

Alcune funzioni predefinite sono a vostra disposizione per memorizzare la data e l’ora correnti anziché date specifiche. Se invece vi interessa utilizzare la data corrente oppure la data e l’ora correnti insieme, dovete ricorrere a una funzione diversa.

Procedura per la data corrente

Se vi interessa solo la data composta da anno, mese e giorno, potete utilizzare una funzione della classe date di Python di nome “today”. Eseguire la funzione è semplice:

import datetime as dt
current_date = dt.date.today()

Per eseguire la funzione today è necessario indicare innanzitutto il modulo datetime, che nell’esempio precedente contiene l’alias dt. Successivamente, utilizzate la notazione con punto per accedere alla classe date, nella quale è specificata a sua volta la funzione today. Dopo aver eseguito il codice sopra indicato, la variabile di nome current_date contiene un oggetto date di Python con la data corrente.

Procedura per la data e l’ora correnti insieme

Se vi serve anche l’ora corrente, potete ricorrere a una funzione della classe datetime: now. Eseguendo la funzione now otterrete un oggetto datetime di Python che, oltre alla data corrente, contiene anche l’ora esatta, fino al singolo millisecondo.

import datetime as dt
current_date_and_time = dt.datetime.now()

L’esecuzione è analoga a quella della funzione today, ma nell’ambito della classe datetime. Dopo l’esecuzione della funzione, la variabile “current_date_and_time” contiene un oggetto datetime con la data e l’ora correnti.

Formattazione di date in Python

La formattazione di oggetti datetime e date è particolarmente importante quando è necessario ottenere come risultato una data nel formato adatto allo scopo della vostra applicazione. Anche in questo caso il modulo Python datetime dispone di un’idonea funzione di nome strftime.

La sintassi della funzione si presenta così:

import datetime as dt
current_date = dt.date.today()
current_date.strftime(format)

La funzione viene eseguita direttamente su un oggetto date o datetime e accetta un determinato formato come parametro di passaggio. Il formato va inserito sotto forma di stringa di Python, ossia tra virgolette. A tal fine Python supporta vari formati diversi; nella tabella seguente è riportato un riepilogo delle relative abbreviazioni: