Template:RA

Template protetto – Le modifiche possono essere proposte nella pagina di discussione.

Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:RA/man (modifica · cronologia)
Sandbox: Template:RA/Sandbox (modifica · cronologia) · TemplateStyles: Template:RA/styles.css (modifica · cronologia) · Tutte le sottopagine: lista

05^h 34^m 31,97^s

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

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

{{RA|00|45|00}}

produce il risultato visibile all'inizio di questa pagina.

Funzionamento

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:

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

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.

Pagine correlate

{{DEC}} - template equivalente per inserire la declinazione

Dati per VisualEditor
La tabella TemplateData che segue è contenuta nella sottopagina Template:RA/TemplateData (modifica·cronologia)

Il template RA è da utilizzare per generare la stringa formattata delle coordinate di ascensione retta

Parametri template[Modifica dati del modello]
Parametro		Descrizione	Tipo	Stato
Ore	`1`	Indicare qui ore (tra 0 e 23)	Numero	obbligatorio
Minuti	`2`	Indicare qui minuti (tra 0 e 59)	Numero	facoltativo
Secondi	`3`	Indicare qui secondi (tra 0 e 59)	Numero	facoltativo