Template:DEC

<includeonly>{{{1}}}&deg;&nbsp;{{#if:{{{2|}}} | {{#ifeq:{{{2|}}} |:| <nowiki>:</nowiki> | {{{2|}}}&prime;&nbsp;{{#if:{{{3|}}} | {{#ifeq:{{{3}}} |:| <nowiki>:</nowiki> | {{{3|}}}&Prime; }} | <nowiki>:</nowiki> }}  }}  | <nowiki>:</nowiki> }}</includeonly><noinclude>
<div style="float:right;border:solid gray 1px;text-align:center;margin:0.5em;padding:0.5em;">{{DEC|+05|34|31,97}}<br /><br /><span style="background:#F5F5F5;padding:4px;">''Un esempio di applicazione''</span></div>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  è 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 gradi, primi e secondi per la declinazione della stella (o di altro oggetto celeste). Le voci in '''<span style="color:green;">verde</span>''' sono opzionali.

<div style="width:70%; padding:.5em 1em; border: 1px dotted gray; background: #EFE; font-size:100%"> 
<tt>
<strong><nowiki>{{</nowiki></strong>'''DEC | &lt;gradi&gt; | <span style="color:green">&lt;primi&gt;</span> | <span style="color:green">&lt;secondi&gt;</span> <nowiki>}}</nowiki>'''
</div>
</tt>
</div>
Al posto delle parole fra parentesi angolari (&lt; e &gt;) vanno inseriti i valori numerici rispettivamente di:
<tt>
*'''gradi''' (obbligatorio)
*'''<span style="color:green;">primi</span>''' (opzionale)
*'''<span style="color:green;">secondi</span>''' (opzionale)
</tt>

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.

=== Esempio ===
 <nowiki>{{DEC|+05|34|31,97}}</nowiki>
produce il risultato visibile all'inizio di questa pagina.

=== Funzionamento ===

Per convenzione, si utilizzano i "due punti" <tt>(':')</tt> 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:

{| class="wikitable" 
|-
|colspan=3 align=center | '''Test sul template:'''
|-
! #  || Valori immessi || Risultato
|-
| '''1.''' || <tt><nowiki>{{DEC|-10|30|45}}</nowiki></tt>  || <tt>{{DEC|-10|30|45}}</tt>
|-
| '''2.''' || <tt><nowiki>{{DEC|-10|30|:}}</nowiki></tt>  || <tt>{{DEC|-10|30|:}}</tt>
|-
| '''3.''' || <tt><nowiki>{{DEC|-10|:|45}}</nowiki></tt> || <tt>{{DEC|-10|:|45}}</tt>
|-
| '''4.''' || <tt><nowiki>{{DEC|-10|:|:}}</nowiki></tt>    || <tt>{{DEC|-10|:|:}}</tt>
|-
| '''5.''' || <tt><nowiki>{{DEC|-10|30|}}</nowiki></tt>    || <tt>{{DEC|-10|30|}}</tt>
|-
| '''6.''' || <tt><nowiki>{{DEC|-10||45}}</nowiki></tt>   || <tt>{{DEC|-10||45}}</tt>
|-
| '''7.''' || <tt><nowiki>{{DEC|-10|:|}}</nowiki></tt> || <tt>{{DEC|-10|:|}}</tt>
|-
| '''8.''' || <tt><nowiki>{{DEC|-10| |:}}</nowiki></tt> || <tt>{{DEC|-10| |:}}</tt>
|}
<div style="clear:left;"></div>

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.
[[Categoria:Template misurazioni]]
</noinclude>