Modulo:Data/man
Questa è la pagina di documentazione per Modulo:Data
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.
- 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_yms
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_yms|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_yms|from=2016/01/01|to=2015/01/01}}ritornerà: Errore script: la funzione "diff_yms" non esiste.{{#invoke:Data|diff_yms|from=2016/01/01|to=2017/03/04}}ritornerà: Errore script: la funzione "diff_yms" non esiste.{{#invoke:Data|diff_yms|from=2016/01/01|to=2012/12/31}}ritornerà: Errore script: la funzione "diff_yms" non esiste.
Unit test
Unit test per questo modulo sono disponibili a Modulo:Data/test, per la loro esecuzione visitare Discussioni_modulo:Data/test.