Modulo:Data/man: differenze tra le versioni

Versione delle 10:43, 20 mag 2015

Versione delle 10:51, 20 mag 2015

Riga 14:

:''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. È utile quando il modulo è usato in un template: pur non conoscendo a priori le date che verranno utilizzate si può così stabilire una unità minima che verrà visualizzata.

:''direzionedir'': se impostato a qualunque valore, esempio "direzionedir=sì", nel risultato invece del segno verrà utilizzato il prefisso "tra" se positivo (esempio: "tra 1 mese") o verrà appeso "fa" se negativo (esempio "un mese fa").

;Esempi

Riga 21:

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01}}

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|magnitudine=anni}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|magnitudine=anni}}

Gli stessi esempi con dir=sì:

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2016/02/10|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2016/02/10|dir=sì}}

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2016/02/10|magnitudine=mesi|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2016/02/10|magnitudine=mesi|dir=sì}}

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|dir=sì}}

*<code><nowiki>{{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|magnitudine=anni|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff|inizio=2016/01/01|fine=2014/07/01|magnitudine=anni|dir=sì}}

=== diff_ymd ===

Riga 31 ⟶ 37:

:''inizio'': data di partenza

:''fine'': data di arrivo, può essere successiva o anteriore a inizio, se anteriore verrà anteposto il segno "-" (meno) al risultato.

:''direzionedir'': se impostato a qualunque valore, esempio "direzionedir=sì", nel risultato invece del segno verrà utilizzato il prefisso "tra" se positivo (esempio: "tra 1 mese e 1 giorno") o verrà appeso "fa" se negativo (esempio "un mese e un giorno fa").

;Esempi

Riga 37 ⟶ 43:

*<code><nowiki>{{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2017/03/04}}</nowiki></code> ritornerà: {{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2017/03/04}}

*<code><nowiki>{{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2012/12/31}}</nowiki></code> ritornerà: {{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2012/12/31}}

Gli stessi esempi con dir=sì:

*<code><nowiki>{{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2015/01/01|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2015/01/01|dir=sì}}

*<code><nowiki>{{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2017/03/04|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2017/03/04|dir=sì}}

*<code><nowiki>{{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2012/12/31|dir=sì}}</nowiki></code> ritornerà: {{#invoke:Data|diff_ymd|inizio=2016/01/01|fine=2012/12/31|dir=sì}}

== Unit test ==