Template protetto – Le modifiche possono essere proposte nella pagina di discussione.
Info Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:M/man (modifica · cronologia)
Sandbox: Template:M/Sandbox (modifica · cronologia) · TemplateStyles: Template:M/styles.css (modifica · cronologia) · Tutte le sottopagine: lista

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.

Introduzione

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

Valore semplice

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

Valore e unità di misura

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}}

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 kgm/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}}

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

Prefissi e suffissi al valore

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

Sintassi

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.

primo parametro Il primo valore scritto in cifre, senza separatori delle migliaia e con il punto o la virgola come separatore decimale (es. 123456.78 o 123456,78);

Sono accettati anche numeri già formattati a mano, suddivisi da uno spazio ordinario: 299 792 458...;

  • {{M|1234567.1234567}}1234567,1234567
  • {{M|.1234}}0,1234                    (aggiunge lo zero)
  • {{M|+1234}}+1234                     (visualizza il più)
  • {{M|-1234}}−1234                     (rimpiazza il trattino-meno con un segno meno)
  • {{M|12e34}}12×1034                (notazione normalizzata)
fmt Di default i numeri sono formattati con uno spazio che separa ogni gruppi di tre cifre, sia nella parte intera, che frazionale.

Comunque numeri di quattro cifre non sono formattate con spazi, per forzare il comportamento usate il parametro fmt = gaps.
Usate fmt = commas per delimitare la parte intera del numero con punti.
Usate fmt = none per non effettuare alcuna formattazione (niente spazi o punti).
{{M|1234567.1234567}}1234567,1234567
{{M|1234567.1234567|fmt=commas}}1 234 567,1234567
{{M|1234}}1234
{{M|1234|fmt=gaps}}1234
{{M|1234.5}}1234,5
{{M|1234.5|fmt=none}}1234.5

end Aggiunge qualcosa al termine del primo numero (prima di ogni altra cosa che potrebbe seguire).

{{M|11|end=<END>}}11<END>
{{M|11|22|end=<END>}}11<END>±22
{{M|1111|(22)|end=<END>}}1111<END>(22)
{{M|11|22|33|end=<END>}}11<END>+22
−33

{{M|11|ul=m/s|end=<END>}}11<END> m/s

secondo parametro non nominato L'incertezza di misura in uno di due formati.

{{M|11|22|u=m/s}}11±22 m/s
{{M|11|(22)|u=ms}}11(22) ms
Un simbolo di congiunzione per unire due numeri, utile per intervalli, formattare grammaticalmente il risultato, ecc..
{{M|11|-|33|u=m/s}}11-33 m/s
{{M|11|–|33|u=m/s}}11-33 m/s
{{M|11|,|33|u=m/s}}11, 33 m/s
{{M|11|by|33|e=9|u=m/s}}(11 su 33)×109 m/s
{{M|11|and|33|u=m/s|end=$}}11$ e 33$ m/s
{{M|11|or|33|u=m/s}}11 o 33 m/s
{{M|11|to|33|u=m/s}}11 fino a 33 m/s
{{M|11|x|33|u=m/s}}11 × 33 m/s
{{M|11|×|33|u=m/s}}11 × 33 m/s
{{M|11|/|33|u=m/s}}11/33 m/s

terzo parametro non nominato Incertezza asimmetrica

{{M|11|22|33}}11+22
−33

errend o +errend e -errend Aggiunge qualcosa dopo l'incertezza di misura.

{{M|11|22|errend=<Errend>}}11±22<Errend>
{{M|11|22|33|+errend=<+Errend>|-errend=<−Errend>}}11+22<+Errend>
−33<−Errend>

u o ul Il codice unità della misura. Il template inserisce uno spazio dopo il valore e l'unità di misura.

ul L'unità di misura è collegata alla sua voce.
u L'unità di misura non è collegata alla sua voce (in questo caso può contenere markup wiki).
{{M|11|ul=m}}11 m

up o upl Un codice unità, ma invece di uno spazio Val aggiunge una barra prima dell'unità di misura. Serve per inserire un'unità di misura a denominatore, per formare un rapporto.

upl L'unità di misura è collegata alla sua voce.
up L'unità di misura non è collegata alla sua voce (in questo caso può contenere markup wiki).
Il rapporto può essere formato da due codici unitò o da un prefisso e un codice unità. Val aggiungerà parentesi per disambiguare, se il codice unità ha un punto o una barra.
{{M|11|ul=J/C|upl=F/m}}11 (J/C)/(F/m)
{{M|11|upl=acre|p=$}}$11/acro
{{M|11|ul=km/s|upl=Mpc}}11 (km/s)/Mpc
{{M|11|ul=kg.m|upl=s-2}}11 (kg⋅m)/s−2

p Aggiunge un prefisso all'espressione generata dal template. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefiss iniziare con &amp;.

{{M|11|22|ul=m/s|p=<Prefix>}}<Prefix>11±22 m/s
{{M|11|22|ul=m/s|p=<Prefix>&nbsp;}}<Prefix> 11±22 m/s

s Aggiunge un suffisso all'espressione generata dal template. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefiss iniziare con &amp;

{{M|11|22|ul=m/s|s=<Suffix>}}11±22 m/s<Suffix>
{{M|11|22|ul=m/s|s=&nbsp;<Suffix>}}11±22 m/s <Suffix>

e Esponente. In alternativa l'esponente può essere inserito direttamente in coda al numero preceduto da "e" (vedi "primo parametro non nominato" sopra).

{{M|11|22|33|e=11}}11+22
−33
×1011

{{M|11e11|22|33}}11+22
−33
×1011

long scale Di solito un'unità è espressa nella scala corta e un billione significa 1×109. Ma alcune unità hanno una versione lunga, vedi scala lunga e scala corta. Il parametro long scale = on assegna all'unità la scala lunga. Il codice dell'unità cambierà e sarà ordinato diversamente nelle tabelle.
nocategory Impedisce che pagine con errori siano aggiunte alla categoria Errori di compilazione del template M. da usare per pagine di documentazione e test che non devono essere corretti.

Errori

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.

Ordinamento

Il template genera una chiave di ordinamento che tiene conto dell'unità di misura, per cui, per esempio, 100 mm è considerato minore di 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}}
|}
Clicca per ordinare ↓
Test di ordinamento
Mm
4×106 m
km
5×103 m
2 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.

Altri esempi di espressione

Numeri

{{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

Incertezza

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

{{M|1.234|(5)}}1,234(5)

Unità

{{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=&nbsp;[[m/s]]}}1,234 m/s

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

Esponenti

{{M|1.234e5|ul=m}}1,234×105 m
{{M|1.234|e=5|ul=m}}1,234×105 m

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

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

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

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

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

Prefissi/suffissi

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

Numeratore/denominatore

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

Cifre ripetute

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


Template correlati

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

Questo template si usa per uniformare la scrittura di misure di grandezze fisiche, complete di valore, unità di misura e tolleranza

Parametri template[Modifica dati del modello]

Questo template preferisce la formattazione in linea dei parametri.

ParametroDescrizioneTipoStato
Valore numerico1

Le cifre del numero da indicare, senza separatori delle migliaia e con il punto come separatore decimale (es. 123456.78)

Numeroobbligatorio
Incertezza2 incertezza

L'incertezza di misura

Esempio
22
Numerofacoltativo
Incertezza asimmetrica3 incertezza asimmetrica

Incertezza asimmetrica

Esempio
33
Numerofacoltativo
Codice unità di misura con linkul

Il codice unità della misura con il wikilink di collegamento. Il template inserisce uno spazio dopo il valore e l'unità di misura.

Esempio
metri/m
Stringafacoltativo
Codice unità di misura senza linku

Il codice unità della misura senza il wikilink di collegamento. Il template inserisce uno spazio dopo il valore e l'unità di misura.

Esempio
metri/m
Stringafacoltativo
Codice unità di misura al denominatoreupl up

Un codice unità, ma invece di uno spazio Val aggiunte una barra prima dell'unità di misura. Serve per inserire un'unità di misura a denominatore, per formare un rapporto.

Esempio
metri/m
Stringafacoltativo
Formattazionefmt formattazione

Di default i numeri sono formattati con uno spazio che separa ogni gruppi di tre cifre, sia nella parte intera, che frazionale. Comunque numeri di quattro cifre non sono formattate con spazi, per forzare il comportamento usate il parametro fmt = gaps. Usate fmt = commas per delimitare la parte intera del numero con punti. Usate fmt = none per non effettuare alcuna formattazione (niente spazi o punti).

Stringafacoltativo
ENDend

Aggiunge qualcosa al termine del primo numero (prima di ogni altra cosa che potrebbe seguire).

Stringafacoltativo
Errenderrend

Aggiunge qualcosa dopo l'incertezza di misura.

Stringafacoltativo
Prefissop prefisso

Aggiunge un prefisso all'espressione generata dal template. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefisso iniziare con &amp;.

Stringafacoltativo
Suffissos suffisso

Aggiunge un suffisso all'espressione generata dal template. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefisso iniziare con &amp;

Stringafacoltativo
Esponentee esponente

Esponente. In alternativa l'esponente può essere inserito direttamente in coda al numero preceduto da "e" (vedi "primo parametro non nominato" sopra).

Esempio
11
Numerofacoltativo
Scala lungalong scale

Di solito un'unità è espressa nella scala corta e un billione significa 1×109. Ma alcune unità hanno una versione lunga, vedi scala lunga e scala corta. Il parametro long scale = on assegna all'unità la scala lunga. Il codice dell'unità cambierà e sarà ordinato diversamente nelle tabelle.

Valore automatico
on
Stringafacoltativo
Non categorizzarenocategory

Impedisce che pagine con errori siano aggiunte alla categoria Errori di compilazione del template M. da usare per pagine di documentazione e test che non devono essere corretti.

Valore automatico
on
Stringafacoltativo