Modulo:Data/man

Modulo per eseguire operazioni sulle date.

Funzioni

diff

Questa funzione ritorna la differenza tra le date inserite tramite i parametri "from" e "to" in una sola unità tra "anni", "mesi", "settimane", "giorni", "ore", "minuti" e "secondi". L'unità può essere specificata tramite il parametro "magnitudine", se non inserito viene utilizzata automaticamente l'unità più adatta. Se "from" è omesso viene utilizzata la data corrente. Il formato per le date è quello accettato dalla funzione parser #time.

Uso

• {{#invoke:Data|diff|from=data1|to=data2}}

Parametri

from: data di partenza, se non inserita viene utilizzata la data corrente

to: data di arrivo

magnitudine: l'unità da ritornare nel risultato, tra "anni", "mesi", "settimane", "giorni", "ore", "minuti" e "secondi". Se non inserita è utilizzata automaticamente la più adatta.

magnitudine min: quando non è utilizzata magnitudine e il modulo utilizza automaticamente l'unità più adatta, serve per configurare l'unità minima da usare. Se per esempio "magnitudine min" viene impostata a "mesi" allora non verranno usate le unità minori (giorni, minuti e secondi) anche se queste fossero le più adatte.

Esempi

• {{#invoke:Data|diff|from=2016/01/01|to=2016/02/10}} ritornerà: Errore: la data di partenza è obbligatoria
• {{#invoke:Data|diff|from=2016/01/01|to=2016/02/10|magnitudine=mesi}} ritornerà: Errore: la data di partenza è obbligatoria
• {{#invoke:Data|diff|from=2016/01/01|to=2014/07/01}} ritornerà: Errore: la data di partenza è obbligatoria
• {{#invoke:Data|diff|from=2016/01/01|to=2014/07/01|magnitudine=anni}} ritornerà: Errore: la data di partenza è obbligatoria

diff_ymd

Questa funzione ritorna la differenza in anni, mesi e giorni tra le date inserite tramite i parametri "from" e "to". Se "from" è omesso viene utilizzata la data corrente. Il formato per le date è quello accettato dalla funzione parser #time.

Uso

• {{#invoke:Data|diff_ymd|from=data1|to=data2}}

Parametri

from: data di partenza, se non inserita viene utilizzata la data corrente

to: data di arrivo.

Esempi

• {{#invoke:Data|diff_ymd|from=2016/01/01|to=2015/01/01}} ritornerà: Errore: la data di partenza è obbligatoria
• {{#invoke:Data|diff_ymd|from=2016/01/01|to=2017/03/04}} ritornerà: Errore: la data di partenza è obbligatoria
• {{#invoke:Data|diff_ymd|from=2016/01/01|to=2012/12/31}} ritornerà: Errore: la data di partenza è obbligatoria

Unit test

Unit test per questo modulo sono disponibili a Modulo:Data/test, per la loro esecuzione visitare Discussioni_modulo:Data/test.