Template:M/man

Il template {{M}} serve per agevolare e uniformare la scrittura di misure di grandezze fisiche nelle voci, formattando i numeri come previsto dal Manuale di stile.

Può riconoscere anche molte unità di misura e facilitarne la formattazione, opzionalmente aggiungendo in automatico un wikilink. Le unità di misura riconosciute sono elencate in Template:Converti/Man/Conversion data e in Modulo:Val/units.

Quando occorre soltanto separare le migliaia senza unità di misura, il template è equivalente alla più semplice funzione di sistema formatnum.

Questo template è dedicato al gestire valori numerici, specialmente quelli scritti in notazione scientifica, con incertezza di misura o valori di unità fisiche.

Per esprimere un valore, più un'eventuale incertezza simmetrica o asimmetrica si usano i primi tre parametri del template

• {{M|numero}} → numero, formattato con le cifre divise in gruppi di tre separati da uno spazio: {{M|123456.78901}} → 123456,78901
• {{M|numero|incertezza}} → numero ± incertezza, per esempio {{M|123478|56}} → 123478±56
• {{M|numero|(incertezza)}} → numero(incertezza), per esempio {{M|12345|(56)}} → 12345(56)
• {{M|numero|incertezza1|incertezza2}} →numero +incertezza1−incertezza2 per esempio {{M|1234|+56|-78}} → 1234+56
  −78

Per esprimere un'unità di misura si usano i parametri u oppure ul, per esempio:

• {{M|4|u=m2}} → 4 m²
• {{M|4|ul=m2}} → 4 m²

Il valore del parametro ul/u è un "codice unità" (in questo caso m2) che il template usa per formattare il simbolo corrispondente (m² in questo caso). Inoltre se viene usato ul il simbolo viene anche collegato alla voce della corrispondente unità di misura. Un codice unità è semplicemente un'abbreviazione del nome dell'unità, ma questo può diventare discretamente convoluta per unità composte, con "moltiplicatori" o "divisori".

È possibile usare altri due parametri up e upl per indicare un'unità di misura al denominatore:

• {{M|9.8|u=gal|upl=min}} → 9,8 US gal/min
• {{M|9.8|ul=parsec|up=anno}} → 9,8 pc/anno

Per permettere di inserire unità di misura complesse o non previste se il u non viene riconosciuto viene riportato così com'è:

• {{M|5.4|u=[[chilogrammo|kg]]⋅[[metro|m]]/s²}} → 5,4 kg⋅m/s²
• {{M|7.6|u=[[Metro al secondo quadrato|m/s²]]}} → 7,6 m/s²

Si può utilizzare anche per mostrare la sola unità di misura senza numero:

• {{M|ul=m2}} → m²

Il template riconosce i simboli gestiti dal {{Converti}}, più quelli definiti in Modulo:Val/units (questo ha la precedenza in caso di simboli duplicati).

A volte un numero e un codice unità non sono sufficienti. Sono disponibili due parametri per aggiungere un prefisso o un suffisso, p e s.

• {{M|7600|u=C&sdot;Ga|p=>|s=<}} → >7600 C⋅Ga<
• {{M|7600|u=C|p=<span style="color:green"><sup>|s=</sup></span>}} → ^7600 C

Il primo parametro del template deve essere sempre un numero. Il secondo può essere un numero (nel qual caso rappresenta un'incertezza simmetrica), oppure uno dei simboli di intervallo riconosciuti che unisce il primo e il terzo valore.

La validità degli argomenti viene controllata e gli errori sono segnalati in evidenza. Le pagine che contegono errori sono inseriti nella categoria Errori di compilazione del template M, salvo che non venga usato il nocategory.

Il template genera una chiave di ordinamento che tiene conto dell'unità di misura, per cui, per esempio, 100 mm è considerato minore di 1 m e maggiore di 0,00001 km. Ovviamente il confronto tra unità di misura non compatibili (pesi con lunghezze avrà risultati non prevedibili). La chiave di ordinamento per ogni unità ordinabile è visibile a Modulo:Val/units.

Questo è un esempio di una tabella ordinabile, con unità di misura differenti:

{| class="sortable"
! Val sort test
|-
| {{val|3|ul= Mm }}
|-
| {{val|4e6|u= m }}
|-
| {{val|1|u= km }}
|-
| {{val|5e3|u= m}}
|-
| {{val|2|u= m}}
|}

La chiave di ordinamento viene generata con la seguente logica.

1. Il valore numerico è il punto di partenza.
2. Viene applicato l'ordine di magnitudine del prefisso SI, se l'unità ne ha uno
3. Il valore dell'unità dal suo proprio sistema di unità viene applicato
4. Se l'unità è composta ogni subunità viene moltiplicata o divisa per la sua dimensione.
5. Al risultato viene applicata una formula di normalizzazione
6. Il risultato viene aggiunto all'attributo di ordinamento delle tabelle.

{{M|1234567.1234567}} → 1234567,1234567
.{{val|1234567.1234567}}. → .1234567,1234567.
{{M|.1234567|fmt=commas}} → 0,1234567
{{M|+1234567|fmt=commas}} → +1 234 567
{{M|-1234567}} → −1234567

{{M|1.234|0.005}} → 1,234±0,005
{{M|1.234|0.005|e=3}} → (1,234±0,005)×10³
{{M|1.234|+0.005|-0.006}} → 1,234+0,005
−0,006
{{M|1.234|(5)}} → 1,234(5)

{{M|1.234|u=m}} → 1,234 m
{{M|1.234|u=m2}} → 1,234 m²
{{M|1.234|ul=m}} → 1,234 m
{{M|123.4|ul=USgal}} → 123,4 US gal
{{M|12.34|ul=mpgimp}} → 12,34 Miglia per gallone

{{M|12.34|u=deg}} → 12,34°
{{M|1.234|0.005|u='}} → 1,234′±0,005′
{{M|1.234|+0.005|-0.006|u="}} → 1,234″+0,005″
−0,006″

{{M|1.234|u=%}} → 1,234%
{{M|1.234|end= [[m/s]]}} → 1,234 m/s

{{M|12.34|u=degC}} → 12,34 degC
{{M|12.34|u=K}} → 12,34 K

{{M|1.234e5|ul=m}} → 1,234×10⁵ m
{{M|1.234|e=5|ul=m}} → 1,234×10⁵ m

{{M|1.234e7|0.056}} → (1,234±0,056)×10⁷
{{M|1.234|0.056|e=7}} → (1,234±0,056)×10⁷

{{M|1.23456e-9|+0.00007|-0.00008|ul=m/s}} → 1,23456+0,00007
−0,00008×10⁻⁹ m/s
{{M|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}} → 1,23456+0,00007
−0,00008×10⁻⁹ m/s

{{M|1.234e7|0.056|ul=psi}} → (1,234±0,056)×10⁷ psi
{{M|1.234|0.056|e=7|ul=psi}} → (1,234±0,056)×10⁷ psi

{{M|1.234e-2|(5)}} → 1,234(5)×10⁻²
{{M|1.234|(5)|e=-2}} → 1,234(5)×10⁻²

{{M|12.34|p=Δ }} → Δ 12,34
{{M|12.34|u=%|p=≅}} → ≅12,34%
{{M|12.34|0.25|s=%}} → 12,34±0,25%

{{M|1.234|e=7|ul=W|up=m2}} → 1,234×10⁷ W/m²

{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}} → 1,234×10⁷ W/m²

• {{converti}}
• {{,}}
• {{clear}}
• {{sp}}
• {{Tutto attaccato}}