Il template DEC ha lo scopo di presentare, in maniera ben formata, i valori di gradi, minuti primi e secondi d'arco per la Declinazione di un oggetto celeste, corredandoli dei simboli appropriati.
Il template, quindi, prende in input i valori di gradi, primi 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 {{DEC}} è 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.
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 gradi, primi e secondi per la declinazione della stella (o di altro oggetto celeste). Le voci in verde sono opzionali.
{{DEC | <gradi> | <primi> | <secondi> }}
Al posto delle parole fra parentesi angolari (< e >) vanno inseriti i valori numerici rispettivamente di:
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 i gradi vengono sempre inseriti in prima posizione, i primi in seconda posizione e i secondi in terza posizione. In altri termini, il template interpreta il primo valore sempre come gradi, il secondo (se c'è) come primi ed il terzo (se c'è) come secondi.
{{DEC|+05|34|31,97}}
produce il risultato visibile all'inizio di questa pagina.
Il template {{DEC}} 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 {{DEC}}: | ||
# | Valori immessi | Risultato |
---|---|---|
1. | {{DEC|-10|30|45}} | -10° 30′ 45″ |
2. | {{DEC|-10|30|:}} | -10° 30′ : |
3. | {{DEC|-10|:|45}} | -10° : |
4. | {{DEC|-10|:|:}} | -10° : |
5. | {{DEC|-10|30|}} | -10° 30′ : |
6. | {{DEC|-10||45}} | -10° : |
7. | {{DEC|-10|:|}} | -10° : |
8. | {{DEC|-10| |:}} | -10° : |
In questo modo, se un utente conosce soltanto i valori di uno o due parametri principali (cioè gradi e/o primi), può inserire solo quei valori senza preoccuparsi dei relativi simboli, ottenendo comunque un risultato formattato opportunamente.
Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:DEC/TemplateData (modifica·cronologia)
Il template RA è da utilizzare per generare la stringa formattata delle coordinate di ascensione retta
Parametro | Descrizione | Tipo | Stato | |
---|---|---|---|---|
gradi | gradi | Gradi (0-±90) | Stringa | obbligatorio |
primi | primi | Primi (0-59) | Stringa | facoltativo |
secondi | secondi | Secondi (0-59) | Stringa | facoltativo |