Il modulo datetime permette la manipolazione di date e orari
Costanti
| |
|---|
datetime.MAXYEAR | Restituisce il valore massimo ammesso per specificare un anno, 9999 |
datetime.MINYEAR | Restituisce il valore minimo ammesso per specificare un anno, 1 |
Classi / Funzioni
datetime.date()datetime.datetime()datetime.datetime.now()datetime.time()datetime.timedelta()datetime.today()- …
datetime.date()
Un oggetto date contiene le informazioni di una data: giorno, mese, anno.
Costruttori
I metodi di classe restituiscono un oggetto
datetime.date(year, month, day) | Crea un oggetto della classe date utilizzando i valori dei parametri |
datetime.date.today() | Restituisce un oggetto con la data odierna |
datetime.date.fromisocalendar(...)
datetime.date.fromisoformat(...)
datetime.date.fromordinal(...)
datetime.date.fromtimestamp(...) | Restituisce un oggetto che corrisponde alla data specificata con un certo formato |
Vincoli
datetime.MINYEAR <= year <= datetime.MAXYEAR1 <= month <= 12- 1 <= day <= 28/29/30/31
Attributi (di classe)
datetime.date.max | Restituisce il valore massimo ammesso per una data: datetime.date(datetime.MAXYEAR, 12, 31) |
datetime.date.min | Restituisce il valore minimo ammesso per una data: datetime.date(datetime.MINYEAR, 1, 1) |
datetime.date.resolution | Restituisce il valore minimo ammesso come distanza tra due date: datetime.timedelta(days=1) |
Attributi (di istanza)
d.day | Restituisce il valore del giorno, 1 … 28/29/30/31 |
d.month | Restituisce il valore del mese, 1 … 12 |
d.year | Restituisce il valore dell’anno compreso in datetime.MINYEAR ... datetime.MAXYEAR |
Metodi (di istanza)
d.replace(...) | Restituisce un oggetto con i dati di partenza sostituiti da quelli specificati con i parametri year, month, day |
d.timetuple() | … |
d.toordinal() | … |
d.toordinal() | … |
d.toordinal() | … |
d.toordinal() | … |
d.isoweekday() | Restituisce il valore del giorno della settimana (Lunedì –> 1, …) |
d.weekday() | Restituisce il valore del giorno della settimana (Lunedì –> 0, …) |
Operatori
d1 + td | Restituisce una data |
d1 - td | Restituisce una data |
d1 - d2 | Restituisce un intervallo |
d1 == d2
d1 != d2
d1 < d2
d1 <= d2
d1 > d2
d1 >= d2 | Confronti … |
Funzioni
datetime.timedelta()
Un oggetto timedelta contiene la durata di un intevallo di tempo.
Si ottiene dalla differenza tra due date o due orari.
Costruttori
datetime.timedelta(...) | Crea un oggetto della classe … |
Attributi (di classe)
datetime.timedelta.max | L’oggetto con il valore massimo: datetime.timedelta(days=999.999.999, seconds=86.399, microseconds=999.999) |
datetime.timedelta.min | L’oggetto con il valore minimo: datetime.timedelta(days=-999.999.999) |
datetime.timedelta.resolution | L’oggetto con il valore più piccolo: datetime.timedelta(microsecond=1) |
Attributi (di istanza)
Internamente sono salvati giorni, secondi e microsecondi
td.days | Restituisce il numero di giorni: -999.999.999 <= days <= 999.999.999 |
td.seconds | Restituisce il numero di secondi: 0 <= seconds <= 86.399 (< 3.600*24) |
td.microseconds | Restituisce il numero di microsecondi (milionesimi): 0 <= microseconds <= 999.999 |
Metodi (di istanza)
td.total_seconds() | Restituisce il numero totale di secondi contenuti in un oggetto datetime.timedelta
(un giorno -> 86.400 secondi …) |
Operatori
td1 + td2 | Un intervallo con il totale dei due intervalli |
td1 - td2 | … |
td * n
td * x | Multiplo dell’intervallo (eventualmente arrotondato al microsecondo) |
td / n
td // n
td / x | Frazione dell’intervallo (eventualmente arrotondato al microsecondo) |
td1 / td2 | Restituisce un numero in virgola mobile |
td1 % td2 | Restituisce un intervallo |
td1 == td2
td1 != td2 | Confronto tra due oggetti qualsiasi del modulo datetime |
< <=
> >= | Confronto tradue intervalli |
... | … |
Funzioni
abs(td) | … |
divmod(td) | Restituisce quoziente e resto (// e %) |
repr(td) | Restituisce il costruttore corrispondente all’intervallo come stringa |
str(td) | Restituisce una stringa con una certa formattazione dell’intervallo |