Template:RA

Wikibooks, manuali e libri di testo liberi.
Jump to navigation Jump to search
05h 34m 31.97s

Un esempio di applicazione

Il template RA ha lo scopo di presentare, in maniera ben formata, i valori di ore, minuti e secondi per l'Ascensione retta di un oggetto celeste, corredandoli dei simboli appropriati.

Il template, quindi, prende in input i valori di ore, minuti e secondi, e li mostra opportunamente in output, con l'aggiunta dei simboli specifici.

È sempre possibile scrivere direttamente i valori di ore, minuti e secondi per l'Ascensione retta di un dato oggetto, quindi senza ricorrere a questo template; tuttavia, l'uso del template {{RA}} è raccomandato, in quanto, oltre offrire alla comodità di non dovere aggiungere a mano i simboli, presenta anche alcuni vantaggi dovuti alla logica in esso implementata.

Guida all'utilizzo[modifica]

Copiare il testo presente nel box colorato e incollarlo all'inizio della voce in cui si vuole che il template appaia; inserire quindi i valori di ore, minuti e secondi per l'Ascensione retta della stella (o di altro oggetto celeste). Le voci in verde sono opzionali.

{{ RA | <ore> | <minuti> | <secondi> }}

Al posto delle parole fra parentesi angolari (< e >) vanno inseriti i valori numerici rispettivamente di:

  • ore (obbligatorio)
  • minuti (opzionale)
  • secondi (opzionale)

L'identificazione dei parametri, da parte del template, è posizionale, nel senso che il template è in grado di associare correttamente i simboli ai valori solo se le ore vengono sempre inserite in prima posizione, i minuti in seconda posizione e i secondi in terza posizione. In altri termini, il template interpreta il primo valore sempre come ore, il secondo (se c'è) come minuti ed il terzo (se c'è) come secondi.

Esempio[modifica]

{{RA|05|34|31.97}}

produce il risultato visibile all'inizio di questa pagina.

Funzionamento[modifica]

Il template {{RA}} effettua una serie di controlli sui valori che riceve in input, evitando che si producano risultati assurdi.
Per convenzione, si utilizzano i "due punti" (':') per indicare il valore minimo. Per questo motivo, se si inserisce il simbolo dei due punti, il template non si aspetta più alcun valore dopo tale simbolo, e ignora l'eventuale valore fornito come terzo parametro. Un discorso analogo vale per lo spazio vuoto (o l'assenza di parametro opzionale), che viene convertito automaticamente dal template nel simbolo dei due punti.

Alcuni esempi:

Test sul template {{RA}}:
# Valori immessi Risultato
1. {{RA|10|30|45}} 10h 30m 45s
2. {{RA|10|30|:}} 10h 30m :
3. {{RA|10|:|45}} 10h :
4. {{RA|10|:|:}} 10h :
5. {{RA|10|30|}} 10h 30m :
6. {{RA|10||45}} 10h :
7. {{RA|10|:|}} 10h :
8. {{RA|10| |:}} 10h :

In questo modo, se un utente conosce soltanto i valori di uno o due parametri principali (cioè ore e/o minuti), può inserire solo quei valori senza preoccuparsi dei relativi simboli, ottenendo comunque un risultato formattato opportunamente.