Template:Converti

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

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

Il template {{Converti}} serve a calcolare la conversione da un'unità di misura a un'altra e a visualizzare il risultato, si può utilizzare per mostrare grandezze misurate in due diversi sistemi di unità di misura, come nei seguenti esempi:

{{Converti|32|m|ft|1}} → 32 metri (105,0 ft)

{{Converti|18|°C|°F|1}} → 18 °C (64,4 °F)

Uso: sintassi semplificata

{{converti|valore|unità_input|unità_output|arrotondamento}}

Dove:

valore: il valore da convertire, per evitare ambiguità con importazioni da altre wiki il template riconosce sia il punto (".") che la virgola (",") come divisore tra la parte intera e decimale.
unità_input: il codice dell'unità di misura del valore da convertire (normalmente il suo simbolo, ma il template riconosce anche alcuni nomi e alias per le unità più comuni). È sensibile alle maiuscole/minuscole, quindi per esempio "kW" viene riconosciuto come Chilowatt ed è corretto, mentre "KW" non viene riconosciuto e il template genererà un messaggio di errore.
unità_output: (opzionale) l'unità di misura in cui convertire il valore. Se non viene inserita il template deciderà automaticamente quale unità utilizzare per effettuare la conversione (per esempio inserendo {{converti|10|ft}} il template selezionerà automatica il metro come unità di output effettuando una conversione da metri a piedi: 10 piedi (3,0 m)
arrotondamento: (opzionale) la precisione (il numero di cifre significative) a cui arrotondare il risultato. Se non viene inserito il template deciderà automaticamente la precisione da usare in base alle cifre significative del valore da convertire.

Il comportamento normale del template è di visualizzare il valore nell'unità di input seguito dal valore nell'unità di output tra parentesi. Il nome della prima unità di misura viene scritto per esteso, mentre dell'unità di output viene abbreviato. Il comportamento del template può comunque essere modificato usando le opzioni descritte più sotto.

Uso: sintassi completa

Convertendo una singola unità di misura (nota: è comunque riportato solo un sottoinsieme delle opzioni disponibili per i vari parametri, consultare la tabella per vedere tutte le opzioni utilizzabili):

{{converti|valore|unità_input|unità_output|arrotondamento|abbr=on/off/in|sigfig=n|round=n|disp=opzione|order=flip}}

Convertendo un intervallo di valori:

{{converti|valore1|separatore di intervallo|valore2|unità_input1|unità_output|arrotondamento|abbr=on/off/in|sigfig=n|round=n|lk=in/on/off/out|sortable=on}}

Riassunto dei parametri e opzioni accettate

Per compatibilità con l'importazione del template da en.wiki le opzioni comprendono come alias il corrispondente nome dell'opzione su en.wiki

Opzione	Uso	Valori accettati	Effetto
abbr	Nome o simbolo	in	Usare il simbolo/i per l'unità da cui convertire
		off	Usare i nomi per tutte le unità
		on	Usare simboli per tutte le unità di misura
		out	Usare il simbolo/i per l'unità di misura in cui convertire
		values	Visualizzare solo i numeri, non le unità di misura
		~	Visualizzare sia il simbolo che il nome dell'unità di misura
comma	Controllo del separatore tra gruppi di cifre	5	Usare il separatore tra gruppi di cifre solo per numeri di 5 o più cifre
		gaps	Separare i gruppi di numeri usando uno spazio sottile (`<span style="margin-left: 0.25em">`) invece del separatore predefinito.
		gaps3	Raggruppare solo in tre piuttosto che il default di no gap prima di una cifra singola dopo una virgola decimale???
		off	Non usare il separatore di gruppi di numeri
debug	debug del risultato	yes	Visualizza la chiave di ordinamento a scopo di debug
disp	Opzioni per la visualizzazione del risultato	b	Inserisce il risultato tra parentesi tonde e unisce con uno spazio '(...)'. Il comportamento di default.
		(o)	Inserisce il risultato tra parentesi tonde '(...)' e unisce con un "o" valore da convertire e risultato. Alias "(or)"
		br	Separa il valore originale e il risultato della conversione con un '<br>'. Il risultato non è inserito tra parentesi
		br()	Separa il valore originale e il risultato della conversione con un '<br>'. Il risultato è inserito tra parentesi
		virgola	Separa il valore originale e il risultato della conversione con una virgola. Il risultato è inserito tra parentesi. Alias "comma"
		numero	Visualizza solo il valore numerico del risultato della conversione. Alias "number"
		o	unisce valore originale e convertito con una " o " invece di inserire il valore convertito tra parentesi. Alias: "or")
		risultato	Visualizza solo il risultato della conversione, (valore e unità di misura). Alias dell'opzione: "out" e "output only"
		valore risultato	Visualizza solo il risultato numerico della conversione. Alias "output number only"
		preunità	Visualizza un testo fornito dall'utente tra il valore numerico e l'unità di misura. Il testo deve essere inserito come parametro non nominato dopo i parametri normali. Se si inseriscono due testi aggiuntivi il primo è inserito tra il valore e l'unità di misura del valore da convertire, mentre il secondo tra il valore del risultato della conversione e la sua unità di misura. Alias "preunit"
		quadre	Il risultato della conversione viene inserito tra parentesi quadre, '[...]', invece che tonde. Alias "sqbr"
		tabella	Visualizza solo i valori numerici del valore originale e del risultato della conversione, formattati per essere inseriti una tabella con allineamento del testo a destra. Alias "table"
		tabellac	Visualizza solo i valori numerici del valore originale e del risultato della conversione, formattati per essere inseriti una tabella con allineamento del testo al centro. Alias "tablecen"
		unità	Visualizza solo il simbolo dell'unità di misura da cui convertire. Alias "unit"
		unità2	Visualizza solo il simbolo dell'unità di misura in cui convertire. Alias "unit2"
		unità o testo	Visualizza solo il simbolo/nome dell'unità o il codice unità inserito se questo non è riconosciuto. Alias "unit or text"
		x	Unisce il valore da convertire con il risultato della conversione con il testo specificato dall'utente
frac	Visualizzare il risultato della conversione come frazione	x	x deve essere un numero maggiore o uguale a 2 che viene usato come denominatore per il risultato della conversione
lk	Collegare il nome o l'unità di misura alla voce	in	Inserire il collegamento per l'unità di misura da cui convertire
		off	Non inserire il collegamento
		on	Inserire il collegamento sia per l'unità di misura da cui convertire che per quella di default
		out	Inserire il collegamento per l'unità di misura in cui convertire
order	ordine dei valori	flip	Visualizza il risultato della conversione prima del valore da convertire
round	arrotondamento	x	Il risultato è arrotondato a un multiplo di x.
round	arrotondamento	each	Arrotonda il risultato della conversione di ogni valore di un intervallo alla sua precisione di default piuttosto che usare la precisione maggiore dei valori dell'intervallo
sigfig	Cifre significative	x	Il risultato viene calcolato con un numero x di cifre significative. x deve essere un numero intero maggiore di zero. Di default il numero significative del risultato è pari a quella del valore da convertire (o due se inferiore a due)
sortable	Chiave di ordinamento	off	Ignorato (è il valore di default)
sortable	Chiave di ordinamento	on	Genera una chiave di ordinamento per l'uso in una tabella ordinata. La chiave è basata sulla conversione del valore da convertire a una base standard. Sinonimi "in" e "out"
adj^{[tab 1]}	Forma aggettivata	j	Valore e unità di misura sono uniti da uno spazio non interrompibile " " invece che da uno spazio
		mid	Forma aggettivata con un testo specificato dall'utente tra valore da convertire e valore convertito. Il testo è da inserire come parametro non nominato.
		off	Ignorato (è il valore di default)
		on	Usa la forma aggettivata inglese: nome dell'unità al singolare unita al valore da un trattino (A 10-mile distance invece di A distance of 10 miles).
		pre	testo specificato dall'utente prima del valore da convertire
		ri0	Arrotonda il risultato con precisione = 0
		ri1	Arrotonda il risultato con precisione = 1
		ri2	Arrotonda il risultato con precisione = 2
		ri3	Arrotonda il risultato con precisione = 3

^ adj è stato incluso solo per motivi di compatibilità con l'importazione del parametro da en.wiki, dato che può essere stato usato anche per alcune opzioni diverse dalla costruzione della forma aggettivata inglese.

Nome o simbolo 1 kg o 1 chilogrammo ?

Solitamente il template visualizza il nome completo della prima unità di misura e il simbolo della seconda, per esempio {{Converti|1|lb|kg}} → 1 libbra (0,45 kg). Per cambiare questo comportamento si può usare l'opzione abbr = on/off/in:

abbr = on: visualizza i simboli per tutte le unità di misura: {{Converti|1|lb|kg|abbr=on}} → 1 lb (0,45 kg)
abbr = off: visualizza il nome esteso per tutte le unità di misura: {{Converti|1|lb|kg|abbr=off}} → 1 libbra (0,45 chilogrammi)
abbr = in: inverte il comportamento solito, visualizza il simbolo per l'unità da convertire e il nome per quella in cui convertire: {{Converti|1|lb|kg|abbr=in}} → 1 lb (0,45 chilogrammi)

Il simbolo è sempre invariante, il nome dell'unità può assumere la forma singolare a seconda del valore:

{{Converti|1|metro}} → 1 metro (3 ft 3 in)
{{Converti|2|metro}} → 2 metri (6 ft 7 in)
{{Converti|2|metro|abbr=on}} → 2 m (6 ft 7 in)

Arrotondamento: 100 ft è 30 m o 30,5 m o 30,48 m?

Per definizione 100 ft equivalgono a 30,48 m. Ma nell'uso pratico è spesso comune arrotondare il risultato. Il template offre diverse possibilità per farlo.

Comportamento standard

Il template arrotonda automaticamente il risultato della conversione a una precisione paragonabile a quella del valore da convertire. L'arrotondamento è impostato pari al numero di cifre dopo il punto decimale o nel caso di un numero intero al negativo del numero zeri non significativi. Se il rapporto di conversione tra le due unità di misura è compreso tra 0,02 e 0,2 l'arrotondamento è aumentato di uno, se il rapporto di conversione è compreso tra 0,2 e 2 rimane lo stesso, se è compreso tra 2 e 20 viene decrementato di 1 così via. Se l'arrotondamento viene ridotto a meno di due cifre significative allora è impostato a due cifre significative. L'arrotondamento di temperature fa eccezione a questo comportamento, vedi Arrotondare temperature più avanti.

Un valore di arrotondamento uguale a 0 significa arrotondare all'unità, pari a uno arrotondare a un decimo, pari a 2 arrotondare a un centesimo e così via. Per i numeri negativi arrotondare a -1 significa arrotondare alla decina, a -2 arrotondare alla centinaia, ecc...

Esempi dell'arrotondamento automatico

Conversione da metri a piedi, il fattore di conversione è 1 piede (0,3048 m)^{[converti: opzione non valida]} quindi non ci sono modifiche al valore di arrotondamento calcolato:

Esempio	Note
`{{Converti\|1\|m\|ft}}` → 1 metro (3,3 ft)	Valore di arrotondamento calcolato = 0, corretto a due cifre significative
`{{Converti\|1\|m\|ft\|0}}` → 1 metro (3 ft)	Per confronto con valore di arrotondamento forzato = 0
`{{Converti\|1,0\|m\|ft}}` → 1,0 metro (3,3 ft)	Valore di arrotondamento calcolato = 1, corretto a due cifre significative
`{{Converti\|1,00\|m\|ft}}` → 1,00 metro (3,28 ft)	Valore di arrotondamento calcolato = 2
`{{Converti\|1,000\|m\|ft}}` → 1,000 metro (3,281 ft)	Valore di arrotondamento calcolato = 3
`{{Converti\|10\|m\|ft}}` → 10 metri (33 ft)	Valore di arrotondamento calcolato =-1, corretto a due cifre significative
`{{Converti\|12\|m\|ft}}` → 12 metri (39 ft)	Valore di arrotondamento calcolato = 0, corretto a due cifre significative
`{{Converti\|100\|m\|ft}}` → 100 metri (330 ft)	Valore di arrotondamento calcolato = -2
`{{Converti\|100\|m\|ft\|0}}` → 100 metri (328 ft)	Per confronto valore di arrotondamento fissato a zero
`{{Converti\|1000\|m\|ft\|0}}` → 1 000 metri (3 281 ft)	Valore di arrotondamento calcolato = -3
`{{Converti\|1234\|m\|ft}}` → 1 234 metri (4 049 ft)	Valore di arrotondamento calcolato = 0
`{{Converti\|10,0\|m\|ft}}` → 10,0 metri (32,8 ft)	Valore di arrotondamento calcolato = 1
`{{Converti\|10,00\|m\|ft}}` → 10,00 metri (32,81 ft)	Valore di arrotondamento calcolato = 2
`{{Converti\|10,000\|m\|ft}}` → 10,000 metri (32,808 ft)	Valore di arrotondamento calcolato = 3
`{{Converti\|100,0\|m\|ft}}` → 100,0 metri (328,1 ft)	Valore di arrotondamento calcolato = 1
`{{Converti\|1000,0\|m\|ft}}` → 1 000,0 metri (3 280,8 ft)	Valore di arrotondamento calcolato = 1

Esempi di arrotondamento:

{{Converti|123|ft|m}} → 123 piedi (37 m): Comportamento normale
{{Converti|123|ft|m|0}} → 123 piedi (37 m): Arrotonda all'unità
{{Converti|123|ft|m|1}} → 123 piedi (37,5 m): Arrotonda a una cifra decimale
{{Converti|123|ft|m|2}} → 123 piedi (37,49 m): Arrotonda a due cifre decimali
{{Converti|550|ft|m|0}} → 550 piedi (168 m): Il valore approssimato è 167,64 m
{{Converti|550|ft|m}} → 550 piedi (170 m): Arrotondato a 170, con il valore approssimato pari a 167,4 m
{{Converti|500|ft|m|0}} → 500 piedi (152 m): Il valore approssimato è 152,4 m
{{Converti|500|ft|m}} → 500 piedi (150 m): Arrotondato a 150, mentre il valore approssimato è 152,4

Il template offre quattro tipi di arrotondamento.

Arrotondare a una data precisione

La precisione desiderata viene specificata con il quarto parametro (il terzo se se il unità_output è stato omesso, il quinto se viene specificato un intervallo, o ancora il quarto se viene specificato un intervallo ma non l'unità_output). La conversione viene arrotondata alla più vicina potenza di un decimo di questo numero. Per esempio se il risultato è 8621 e il valore di arrotondamento è -2: precision = -2 il risultato sarà 8600. Se il risultato è "234,0283043" e l'arrotondamento richiesto è "2" il risultato sarà "234,02", se l'arrotondamento richiesto è "0" il risultato sarà 234.

Arrotondare a un dato numero di cifre significative: `sigfig`

Con il parametro sigfig = <n> si può indicare il numero di n cifre significative desiderate. n deve essere un numero intero positivo:

{{Converti|1200|ft|m}} → 1 200 piedi (370 m)
{{Converti|1200|ft|m|sigfig=4}} → 1 200 piedi (365,8 m)
{{Converti|1200|ft|m|sigfig=3}} → 1 200 piedi (366 m)
{{Converti|1200|ft|m|sigfig=2}} → 1 200 piedi (370 m)
{{Converti|1200|ft|m|sigfig=1}} → 1 200 piedi (400 m)

Arrotondare a multipli di 5: 15, 20, 25, ... `round`

Con parametro round = <x> si può indicare di arrotondare il risultato della conversione a un multiplo di x, dove x può essere 0,5, 5, 10, 25, 50 o "each"

Per esempio round = 5 arrotonda il risultato a un multiplo di 5.
{{Converti|10|m|ft}} → 10 metri (33 ft)

{{Converti|10|m|ft|round=5}} → 10 metri (35 ft)
Invece round = 25 arrotonda il risultato a un multiplo di 25:
{{Converti|10|m|ft}} → 10 metri (33 ft)

{{Converti|10|m|ft|round=25}} → 10 metri (25 ft)
per confronto stesso valore convertito con 4 cifre significative:
{{Converti|10|m|ft|sigfig=4}} → 10 metri (32,81 ft)

Nel caso sia inserito una serie di valori da convertire è possibile arrotondare ogni valore individualmente alla sua precisione di default. Usare round = each:

{{Converti|10 x 200 x 3000|m|ft}} → 10 per 200 per 3 000 metri (33 ft × 656 ft × 9 843 ft)

{{Converti|10 x 200 x 3000|m|ft|round=each}} → 10 per 200 per 3 000 metri (33 ft × 660 ft × 9 800 ft)

Arrotondare a multipli di una frazione, `frac`

Con il parametro frac = <n> si può specificare il denominatore di una frazione a cui arrotondare il risultato della conversione. Il valore di n deve essere un intero positivo.

{{Converti|5.56|cm|in|frac=16}} → 5,56 centimetri (2 ³⁄₁₆ in)

{{Converti|8|cm|in|frac=4}} → 8 centimetri (3 ¹⁄₄ in)

La frazione è ridotta quando possibile:

{{Converti|8|cm|in|frac=100}} → 8 centimetri (3 ³⁄₂₀ in)

Per confronto: {{Converti|8|cm|in|sigfig=4}} → 8 centimetri (3,150 in)

Temperature: arrotondare °C, °F e K

Nel caso delle temperature la conversione usa per l'arrotondamento il numero di cifre significative maggiore tra quelle del valore da convertire e quelle per cui occorrebbero almeno tre cifre per esprimere il risultato in kelvin.

{{Converti|10000|C|F K}} → 10 000 °C (18 000 °F; 10 300 K)
{{Converti|10000,1|C|F K}} → 10 000,1 °C (18 032,2 °F; 10 273,2 K)
{{Converti|-272|C|F K}} → −272 °C (−457,60 °F; 1,15 K)
{{Converti|-272|C}} → −272 °C (−457,60 °F)
{{Converti|-300|C|F K}} → −300 °C (−508,0 °F; −26,9 K)
{{Converti|0|C|F K}} → 0 °C (32 °F; 273 K)

Nell'esempio (1) il valore da convertire ha una sola cifra significativa, ma la precisione della sua temperatura espressa in Kelvin è di tre cifre, quindi viene convertito in Fahrenheit con una precisione di tre cifre. La differenza di 32,2 °C tra risultato della conversione tra l'esempio (1) e (2) è dovuta al fatto che nel secondo esempio aggiungendo 0,1 °C a 10000 °C, questo diventa un numero con cinque cifre significative e quindi viene convertito con una precisione maggiore. La differenza diventa minima se si forza a cinque cifre anche la temperatura dell'esempio (1): {{Converti|10000|C|sigfig=5}} → 10 000 °C (18 032 °F) o si forza l'arrotondamento all'unità della conversione: {{Converti|10000|C|K|0}} → 10 000 °C (10 273 K)

Convertire in più unità di misura

Per convertire un valore in più unità di misura è sufficiente inserire i codici delle unità di misura in cui convertire separandoli con spazi:

{{Converti|10|C|F K}} → 10 °C (50 °F; 283 K)

{{Converti|5|km|mi nmi}} → 5 chilometri (3,1 mi; 2,7 nmi)

Se uno dei codici di unità di misura in cui si vuole convertire contiene spazi si possono unire usando un '+'

Intervalli di valori

Si possono inserire due o più valori da convertire dalla stessa unità di misura, separando il risultato con varie opzioni. Questo può essere utile per inserire intervalli (per esempio da "10–100 metri (33–328 ft)) o per inserire una misura con un margine di errore (per esempio "100 ± 5 metri (328 ± 16 ft)")

L'indicatore del tipo di intervallo può essere inserito come secondo parametro del template, quindi la sintassi d'uso del template diventa:

{{converti|valore1|separatore di intervallo|valore2|unità_input|unità_output|arrotondamento}}

Oppure si può inserire direttamente l'intervallo nel primo parametro:

{{converti|valore1 separatore di intervallo valore2|unità_input|unità_output|arrotondamento}}

Segue la tabella dei principiali separatori riconosciuti dal template, il template riconosce per motivi di compatibilità con importazioni da en.wiki anche i codici usati da quest'ultima (per esempio "and" come sinonimo di "e"). Questi sono indicati nelle note dell'opzione, eccetto quando l'uso dell'opzione è deprecato su en.wiki.

Separatore	Esempio di compilazione	Risultato	Note
`-`	`{{converti\|3\|-\|6\|ft}}`	3–6 piedi (0,91–1,83 m)	Il separatore può essere un trattino (-) o una Lineetta (–), il risultato del template usa la lineetta.
`–` `–`(en dash)	`{{converti\|3\|–\|6\|ft}}`	3–6 piedi (0,91–1,83 m)
`e`	`{{converti\|3\|&\|6\|ft}}`	3 e 6 piedi (0,91 e 1,83 m)	Se si vuole separare le unità con "e" usare "&". Il template riconosce la "e" come simbolo della carica elementare e si attende come parametro successivo un'altra unità di misura.
`e(-)`	`{{converti\|3\|e(-)\|6\|ft}}`	3 e 6 piedi (0,91–1,83 m) 3 e 6 ft (0,91–1,83 m) 3 e 6 piedi (0,91–1,83 metri)	Le unità da convertire sono separate da "e", quelle convertite da un trattino
`o`	`{{converti\|3\|o\|6\|ft}}`	3 o 6 piedi (0,91 o 1,83 m)
`fino a`	`{{converti\|3\|fino a\|6\|ft}}`	3 fino a 6 piedi (0,91 fino a 1,83 m)
`fino a(-)`	`{{converti\|3\|fino a(-)\|6\|ft}}`	3 a 6 piedi (0,91–1,83 m)	Le unità da convertire sono separate da "e", quelle convertite da un trattino
`fino a circa`	`{{converti\|3\|fino a circa\|6\|ft}}`	3 fino a circa 6 piedi (0,91 fino a circa 1,83 m)
`+/-`	`{{converti\|3\|+/-\|6\|ft}}`	3 ± 6 piedi (0,91 ± 1,83 m)	Si può usare anche "±"
`+`	`{{converti\|3\|+\|6\|ft}}`	3 + 6 piedi (0,91 + 1,83 m)
`,`	`{{converti\|3\|,\|6\|ft}}`	3, 6 piedi (0,91, 1,83 m)
`per`	`{{converti\|3\|per\|6\|ft}}`	3 per 6 piedi (0,91 per 1,83 m)
`x`	`{{converti\|3\|x\|6\|ft}}`	3 per 6 piedi (0,91 m × 1,83 m)	Notazione scientifica
`×` `×`	`{{converti\|3\|×\|6\|ft}}`	3 per 6 piedi (0,91 m × 1,83 m)
`x\|abbr=on`	`{{converti\|3\|x\|6\|ft\|abbr=on}}`	3 ft × 6 ft (0,91 m × 1,83 m)

Si possono specificare un intervallo di più di due valori, per esempio:

{{Converti|3|x|4|x|24|in}} → 3 per 4 per 24 pollici (76 mm × 102 mm × 610 mm)
{{Converti|3|x|4|to|6+1/2|x|8+3/4|in}} → 3 per 4 fino a 6 ¹⁄₂ per 8 ³⁄₄ pollici (76 mm × 102 mm fino a 165 mm × 222 mm)

Si può specificare un intervallo solo nel primo parametro, inserendo i valori divisi dal separatore:

{{Converti|3.2-7.5|ha}} → 3,2–7,5 ettari (7,9–18,5 acri)
{{Converti|3x4x24|in}} → 3 per 4 per 24 pollici (76 mm × 102 mm × 610 mm)

Non è possibile usare valori da convertire espressi in più unità di misura quando si utilizza un intervallo. Per esempio è possibile inserire una singola misura espressa in piedi e pollici:

{{Converti|1|ft|3|in|mm}} → 1 piede 3 pollici (380 mm) (to compare)

Ma non è possibile farlo se si vuole rappresentare un intervallo:

{{Converti|1|ft|3|in|x|3|ft|5|in|mm}} → 1 piede 3 pollici (^{[converti: unità di misura sconosciuta]})^{[converti: opzione non valida]}

Dimensioni multiple: 6 m × 12 m (20 ft × 39 ft)

Per indicare per esempio un'area indicando le misure dei lati, usare "per", "×" o "x":

{{Converti|6|per|12|ft|m}} → 6 per 12 piedi (1,8 m × 3,7 m)

{{Converti|6|x|12|m|ft}} → 6 per 12 metri (20 ft × 39 ft)

Formalmente si dovrebbero |x| e il parametro abbr = on, in modo che vengano indicate entrambe le dimensioni mantenendo dimensionalmente corretta la formula (un'area sarà espressa in m × m = m²):

{{Converti|6|x|12|m|ft|abbr=on}} → 6 m × 12 m (20 ft × 39 ft)

Testo

Numeri

Prefissi SI

Prefissi SI
Testo	Simbolo	Fattore
yotta	Y	10²⁴
zetta	Z	10²¹
exa	E	10¹⁸
peta	P	10¹⁵
tera	T	10¹²
giga	G	10⁹
mega	M	10⁶
chilo	k	10³
etto	h	10²
deca	da	10¹
(nessuno)	(nessuno)	1
deci	d	10⁻¹
centi	c	10⁻²
milli	m	10⁻³
micro	μ	10⁻⁶
nano	n	10⁻⁹
pico	p	10⁻¹²
femto	f	10⁻¹⁵
atto	a	10⁻¹⁸
zepto	z	10⁻²¹
yocto	y	10⁻²⁴

Si possono usare i simboli dei prefissi SI come G prima del codice delle unità di misura appartententi al Sistema internazionale di unità di misura e il template userà il corrispondente prefisso prima del nome (gigametro). La lettera "u" può essere usata al posto del simbolo per micro "μ".

Per esempio:

{{Converti|12|Gm|m|abbr=on}} → 12 Gm (1,2×10¹⁰ m)
{{Converti|12|μm|m|abbr=on}} → 12 μm (1,2×10⁻⁵ m)
{{Converti|12|Gm|mi|abbr=on}} → 12 Gm (7 500 000 mi)
{{Converti|12000|mi|Mm|abbr=on}} → 12 000 mi (19 Mm)
{{Converti|12|in|μm|abbr=on}} → 12 in (300 000 μm)

Come eccezione i pollici possono avere il prefisso "μ" (micro):

{{converti|12|μm|μin|abbr=on}} → 12 μm (470 μin)

Notazione tecnica: 7 × 10⁶ m

Si può utilizzare la notazione tecnica aggiungendo come prefisso all'unità di misura uno dei codici accettati: e3 (migliaia), e6 (milioni), e9 (miliardi), e12 (biliardi), e15 (quadrilioni). l

{{converti|7|e6m}} → 7 milioni di metri (23 000 000 ft)

È possibile farlo anche per il codice dell'unità di misura del risultato:

{{converti|23000000|ft|e6m}} → 23 000 000 piedi (7,0×10⁶ m)

In generale ogni codice di unità standard può usare un prefisso della notazione tecnica:

Notazione scientifica: 1,23×10⁻¹⁴

Un valore in notazione scientifica può essere inserito come <numero>e<esponente>, per esempio 1,23e4 corrisponde a 1,23×10⁴. Il risultato della conversione è visualizzato in notazione scientifica, eccetto quando compreso tra 0,01 e 1000.

{{Converti|12.3e-15|atm|atm|abbr=on}} → 12,3×10⁻¹⁵ atm (1,23×10⁻¹⁴ atm)
{{Converti|0.00000005|atm|atm|abbr=on}} → 0,00000005 atm (5,0×10⁻⁸ atm)

Valori frazionari: 1 ¹⁄₂ pollici (38,1 mm)

Il valore da convertire può essere espresso come frazione, indicando il numeratore e il denominatore separati da una / (la normale barra della tastiera), oppure dal ⁄ (U+2044, fraction slash):

{{Converti|1/2|in|mm|1}} → ¹⁄₂ pollice (12,7 mm)

{{Converti|1⁄2|in|mm|1}} → ¹⁄₂ pollice (12,7 mm)

Si può aggiungere una frazione a un numero intero usando un segno +

{{Converti|2+1⁄2|in|mm|1}} → 2 ¹⁄₂ pollici (63,5 mm)

Con i numeri negativi si può usare un trattino -, ripetendolo:

{{Converti|-2-1⁄2|in|mm|1}} → −2 ¹⁄₂ pollici (−63,5 mm)

{{Converti|2-1⁄2|in|mm|1}} → 2–¹⁄₂ pollice (50,8–12,7 mm) Nota: questo viene letto come un intervallo

{{Converti|-2+1⁄2|in|mm|1}} → ^{[converti: numero non valido]} Genera errore perché il template dovrebbe valutare l'espressione -2+1/2

Separatore delle migliaia: 1 000 mi or 1000 mi

Usare comma = off per non visualizzare il separatore:

{{Converti|1234567|m|ft|comma=off}} → 1234567 metri (4050417 ft)

Usare comma = gaps per inserire uno spazio sottile come separatore dei gruppi di numeri:

{{Converti|1234567|m|ft}} → 1 234 567 metri (4 050 417 ft) (To compare, default)
{{Converti|1234567|m|ft|comma=gaps}} → 1234567 metri (4050417 ft)

Usare comma = 5 per aggiungere il separatore solo quando il numero di cifre è di cinque o più:

{{Converti|1234|m|ft}} → 1 234 metri (4 049 ft) (per confronto)
{{Converti|1234|m|ft|comma=5}} → 1234 metri (4049 ft)
{{Converti|1234567|m|ft|comma=5}} → 1 234 567 metri (4 050 417 ft)

Manipolazione della visualizzazione del risultato

Parentesi e separatori: 10 m [33 ft]

La punteggiatura che distingue le due misure è controllata dal parametro disp. Le opzioni sono: b (il comportamento normale), quadre, virgola, o, br, x|≈...:

{{Converti|10|m|ft}} → 10 metri (33 ft)—( ) il default è di inserire il risultato tra parentesi tonde

{{Converti|10|m|ft|disp=quadre}} → 10 metri [33 ft]

{{Converti|10|m|ft|disp=virgola}} → 10 metri, 33 ft

{{Converti|10|m|ft|disp=o}} → 10 metri o 33 piedi

Con disp = br si forza un ritorno a capo (<br/>)

{{Converti|10|m|ft|disp=br}} → 10 metri
33 piedi

Invece con disp = br() si forza un ritorno a capo ma si mantengono le parentesi tonde intorno al risultato della conversione:

{{Converti|10|m|ft|disp=br()}} → 10 metri
(33 piedi)

Con disp = x|testo personalizzato si può inserire un testo qualunque come separatore (il testo deve essere inserito in fondo al template come parametro non nominato:

{{Converti|10|m|ft| testo personalizzato |disp=x}} → 10 metri testo personalizzato 33 ft—(per visualizzare gli spazi usare  )

Invertire le due misure: 1 609,3 metri (1 miglio)

Con il parametro order = flip si invertono (scambiano di posto) le due misure:

Ordine normale: {{Converti|1|mi|m}} → 1 miglio (1 600 m)

Ordine invertito: {{Converti|1|mi|m|order=flip}} → 1 600 metri (1 mi)

Quando si converte una misura a più unità di misura l'effetto è:

{{Converti|10|km|mi nmi|order=flip}} → 6,2 miglia; 5,4 miglia nautiche (10 km)

{{Converti|10|km|nmi mi|order=flip}} → 5,4 miglia nautiche; 6,2 miglia (10 km)

Visualizzare solo parti del risultato: 2 (1,5)

È possibile visualizzare solo parte dei risultati:

Codice	Risultato	Note
`{{converti\|2\|cuyd\|m3}}`	2 iarde cubiche (1,5 m³)	Comportamento normale per confronto
`{{converti\|2\|cuyd\|m3\|abbr=valori}}`	2 (1,5)	Solo i valori numerici della misura e della conversione
`{{converti\|2\|cuyd\|m3\|disp=unit}}`	iarde cubiche	Solo l'unità della misura
`{{converti\|2\|cuyd\|m3\|disp=unit\|adj=on}}`	iarda-cubica	Unità da convertire, trattino (forma aggettivata inglese)
`{{converti\|2\|cuyd\|cuyd\|0\|disp=out\|abbr=off}}`	2 iarde cubiche	Input (workaround)
`{{converti\|2\|cuyd\|m3\|abbr=~}}`	2 iarde cubiche [cu yd] (1,5 m³)	Sia il codice dell'unità da convertire che il suo nome
`{{converti\|2\|cuyd\|m3\|disp=unità2}}`	m³	Solo il simbolo dell'unità convertita
`{{converti\|2\|cuyd\|m3\|disp=unità2\|abbr=off}}`	metri cubi	Solo il nome dell'unità convertita (`disp = unità2` fa visualizzare solo la misura convertita, `abbr = off` indica di usare il nome dell'unità di misura invece del simbolo)
`{{converti\|2\|cuyd\|m3\|disp=number}}`	1,5	Solo il valore numerico della conversione
`{{converti\|2\|cuyd\|m3\|disp=out}}`	1,5 m³	Solo il risultato della conversione (simbolo dell'unità di misura e valore)
`{{converti\|2\|cuyd\|m3\|disp=out\|abbr=off}}`	1,5 metri cubi	Solo il risultato della conversione (nome dell'unità di misura e valore)

Visualizzare il nome e il simbolo della misura da cui convertire: 2 kilopascal [kPa]

Usando il parametro abbr = ~ visualizza solo il nome e il simbolo della misura da convertire:

{{Converti|2|kPa|psi|abbr=~}} → 2 chilopascal [kPa] (0,29 psi)

A {{converti|2|kPa|psi|abbr=~|adj=on}} pressure → A 2-chilopascal [kPa] (0,29 psi) pressure

Opzioni per tabelle

Ci sono tre opzioni di supporto all'inserimento di tabelle: aggiungere un'interruzione di linea, dividere il risultato in due colonne e rendere la colonna ordinabile.

Aggiungere interruzioni di linea

disp = br aggiunge un'interruzione di linea ed omette le parentesi.

disp = br() aggiunge un'interruzione di linea ed aggiunge le parentesi intorno al valore convertito. Può essere utile in una tabella:

`disp = br`	`disp = br()`
100 chilometri 62 miglia	100 chilometri (62 miglia)

Visualizzare solo i numeri

Usando il parametro disp = tabella vengono visualizzati solo i valori numerici delle misure e viene aggiunto il wikicode per diviere la misura da convertire e il risultato della conversione in due celle:

{{Converti|10|m|ft|disp=tabella}} → style="text-align:right;"|10

|style="text-align:right;"|33

Con disp = tabellac viene anche aggiunto il codice per centrare orizzontalmente i valori nella cella:

{{Converti|20|m|ft|disp=tabellac}} → style="text-align:center;"|20

|style="text-align:center;"|66

Per esempio (le unità di misura sono aggiunte manualmente nella testata della tabella):

	m	ft
`disp = tabella`	10	33
`disp = tabellac`	20	66
`disp = <altri>` (comportamento di default)	30 metri (98 ft)

Ordinare

Usando il parametro sortable = on il template include nel risultato una chiave di ordnamento adtta per l'uso con le tabelle ordinabili. Tecnicamente questo inserisce una stringa nascosta prima del codice visualizzato:

{{converti|10|m|ft|sortable=on}} → <span style="display:none">7001100000000000000</span>10 metri (33 ft)

Se si usa insieme disp = tabella e sortable = on entrambe le celle includono il codice per l'ordinamento:

	m	ft
A	15 ³⁄₄	52
B	15,5	51
C	16,0	52,5
D	16	52

La chiave di ordinamento generata è calcolata in maniera consistente sia con il valore, che con l'unità di misura della misura. Nella maggior parte dei casi il template converte la misura nell'unità base del SI. Quindi l'ordinamento non è dipendente dall'utilizzare la stessa unità di misura o opzione di visualizzazione nelle celle della stessa colonna, sebbene ci possano essere risultati imprevisti nel caso di arrotondmenti, dato che la chiave di ordinamento non viene arrotondata.

Codici di unità di misura

Il template accetta codici di unità di misura che sono simili, ma non necessariamente identici all'abreviazione tipica per una data unità di misura. Per alcune unità sono possibili codici alternativi, questi sono mostrati tra parentesi di seguito al codice di unità di misura principale, per esempio: °F (F) indica che per indicare un valore in gradi Fahrenheit si può usare sia "°F" che "F" (ma non "f" in minuscolo).

I codici di unità sono sensibili alle maiuscole/minuscole, specialmente in casi come {{converti|100|Mm|mm}}, che genera "100 megametri (1,0×10¹¹ mm)".

Unità 'per' un'altra: kg/hl

Oltre alle unità predefinite il template riconosce anche rapporti di unità definiti. Usando una barra (/), un unità comekg/hl viene riconosciuta come kilogrammi per ettolitro e verrà convertita con altre unità di massa/volume.

{{Converti|1000|kg/hl}} → 1 000 chilogrammi per ettolitro (100 lb/imp gal)

Unità di differenza

Quando un numero misura una differenza viene effettuata una conversione. Questo può succedere nel caso delle temperature (°C, °F, K). Confrontate questo caso a un intervallo in cui vengono effettuate due conversioni.

Le sole unità disponibili sono: variazione C, variazione F e variazione K.

{{Converti|10|C}} → 10 °C (50 °F) -- temperatura normale

{{Converti|10|variazione C}} → 10 °C (18 °F) -- differenza (per esempio "La temperatura è aumentata da 30 a 40 °C")

{{Converti|10-15|C}} → 10–15 °C (50–59 °F) -- intervallo (per esempio "La temperatura è compresa tra 10 e 15 °C")

Consistentemente convertendo in unità multiple:

Un aumento di {{converti|10|variazione C|F-change K-change}} → Un aumento di 10 °C (18 °F; 10 K)

Unità multiple: 1 ft 5 in

Il template accetta un numero predefinito e molto limitato di unità multiple sia per definire la misura da convertire (per esempio inserire una distanza in piedi + pollici e ottenere una lunghezza in metri), sia per indicare come esprimere il risultato (al contrario inserire una distanza in metri e ottenere la sua scomposizione in piedi + pollici)

Nel valore da convertire

È possibile inserire la misura da convertire suddivisa in unità multiple, per un numero limitato di casi predefiniti (vedi la tabella di definizione Input multiples):

Tipo	Unità di misura	Esempio
Area	rood h	`{{Converti\|1\|rood\|2\|sqperch\|m2}}` → 1 rood 2 perch (1 100 m²)
Lunghezza	ch ft	`{{Converti\|1\|ch\|2\|ft\|m}}` → 1 catena 2 piedi (21 m)
	ch yd	`{{Converti\|1\|ch\|2\|yd\|m}}` → 1 catena 2 iarde (22 m)
	chain ft	`{{Converti\|1\|chain\|2\|ft\|m}}` → 1 catena 2 piedi (21 m)
	chain yd	`{{Converti\|1\|chain\|2\|yd\|m}}` → 1 catena 2 iarde (22 m)
	foot in	`{{Converti\|1\|foot\|2\|in\|m}}` → 1 piede 2 pollici (0,36 m)
	ft in	`{{Converti\|1\|ft\|2\|in\|m}}` → 1 piede 2 pollici (0,36 m)
	mi ch	`{{Converti\|1\|mi\|2\|ch\|km}}` → 1 miglio 2 catena (1,6 km)
	mi ft	`{{Converti\|1\|mi\|2\|ft\|km}}` → 1 miglio 2 piedi (1,610 km)
	mi furlong	`{{Converti\|1\|mi\|2\|furlong\|km}}` → 1 miglio 2 furlong (2,0 km)
	mi yd	`{{Converti\|1\|mi\|2\|yd\|km}}` → 1 miglio 2 iarde (1,611 km)
	smi chain	`{{Converti\|1\|smi\|2\|chain\|km}}` → 1 statute mile 2 catena (1,6 km)
	yd ft	`{{Converti\|1\|yd\|2\|ft\|m}}` → 1 iarda 2 piedi (1,5 m)
Massa	lb oz	`{{Converti\|1\|lb\|2\|oz\|kg}}` → 1 libbra 2 oncia (0,51 kg)
	Lcwt qtr	`{{Converti\|1\|Lcwt\|2\|qtr\|kg}}` → 1 quintale inglese 2 quarter (76 kg)
	Lcwt st	`{{Converti\|1\|Lcwt\|2\|st\|kg}}` → 1 quintale inglese 2 stone (64 kg)
	long cwt qtr	`{{Converti\|1\|long cwt\|2\|qtr\|kg}}` → 1 long hundredweight 2 quarter (76 kg)
	LT Lcwt	`{{Converti\|1\|LT\|2\|Lcwt\|t}}` → 1 long ton 2 hundredweight (1,1 t)
	qtr lb	`{{Converti\|1\|qtr\|2\|lb\|kg}}` → 1 quarter 2 libbre (14 kg)
	st lb	`{{Converti\|1\|st\|2\|lb\|kg lb}}` → 1 stone 2 libbre (7,3 kg; 16 lb)
	ST Scwt	`{{Converti\|1\|ST\|2\|Scwt\|t}}` → 1 short ton 2 hundredweight (1,00 t)

Nel risultato della conversione

Sono disponibili alcune unità predefinite in cui può essere scomposto il risultato (vedi tabella di definizione Output multiples):

Unità	Esempio	Note
Lunghezza	miglia yarde piedi pollici	10 chilometri (6 mi 376 yd 0 ft 5 in)
	miglia piedi	10 chilometri (6 mi 1 128 ft)
	iarde piedi pollici	10 chilometri (10 936 yd 0 ft 5 in)
	iarde piedi	1 metro (1 yd 0,3 ft)
	piedi pollici	1 metro (3 ft 3 in)
	piedi pollici	1 metro (3 ft 3 in)
	mani pollici	1 metro (9 h 3 in)
Massa	libbre once	1 chilogrammo (2 libbre 3 oncia)
	stone libbre	10 chilogrammi (1 stone 8 libbre)
	stone libbre once	10 chilogrammi (1 stone 8 libbre 1 oncia)
	stone libbre	10 chilogrammi (1 stone 8 libbre)

Valuta per unità: $/mi, €/km

Usando il simbolo "$" si possono fare varie conversioni di valore monetario per unità:

{{Converti|10|$/mi|$/km}} → $10 per miglio ($6,2/km)

Si può modificare il simbolo di valuta con il parametro $, per esempio $ = €. Questa modifica cambia il simbolo della valuta sia nel valore da convertire che nel valore convertito, per esempio:

{{Converti|10|$/mi|$/km|$=€}} → €10 per miglio (€6,2/km)

Non è possibile fare conversioni tra valute, per esempio non è possibile ottenere un risultato come "$15 per miglio (€8,6/km)"

Opzioni disabilitate

Si elencano queste opzioni perché possono comparire in voci tradotte provenienti da en.wiki ma sono state disabilitate perché non utili/funzionanti su it.wiki:

sp: nel template originale indica di utilizzare la grafia statunitense invece di quella britannica per i nomi delle unità di misura (per esempio meter invece di metre).
spell: indica di visualizzare i numeri in lettere invece che in cifre (ten invece di 10)
extra word: usati in originale in congiunzione con "adj"

Template correlati

{{M}}
{{,}}
{{clear}}
{{sp}}
{{TA}}

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

Questo template si può utilizzare per mostrare grandezze misurate in due diversi sistemi di unità di misura.

Parametri template[Modifica dati del modello]
Questo template preferisce la formattazione in linea dei parametri.
Parametro		Descrizione	Tipo	Stato
Valore	`1`	valore da convertire Valore automatico	Numero	obbligatorio
Unità da convertire	`2`	Unità di misura da convertire (oppure separatore intervalli o simbolo tolleranza (+/- o ±) ) Esempio kg	Stringa	obbligatorio
Unità convertita	`3`	Unità di misura in cui si vuole convertire il valore (oppure secondo valore dell'intervallo o della tolleranza d'errore se usato nel parametro precedente il relativo simbolo) Esempio libbre	Stringa	consigliato
Unità da convertire opz	`4`	(se è stato utilizzato l'intervallo o la tolleranza d'errore qui va inserita l'unità da convertire)	Stringa	facoltativo
Unità convertita opz	`5`	(se è stato utilizzato l'intervallo o la tolleranza d'errore qui va inserita l'unità convertita)	Stringa	facoltativo
abbr	`abbr`	Per abbreviare tutte le unità di misura Valori suggeriti `in` `off` `on` `out` `values` `~` Valore automatico `on`	Sconosciuto	facoltativo
lk	`lk`	Per inserire i collegamenti alle unità di misura Valori suggeriti `in` `off` `on` `out` Valore automatico `on`	Stringa	facoltativo
sigfig	`sigfig`	Numero di cifre significative del risultato	Numero	facoltativo
round	`arrotondamento`	Numero di cifre dopo la virgola	Numero	facoltativo
order	`order`	Visualizza prima il risultato convertito poi quello da convertire Esempio order=flip Valore automatico `flip`	Sconosciuto	facoltativo
Arrotondamento alla frazione	`frac`	Arrotonda alla frazione in cui denominatore (numero intero) è il valore inserito Esempio frac=4 arrotonda il risultato a una frazione con 4 al denominatore	Numero	facoltativo
Formato di visualizzazione	`disp`	Stabilisce il formato della frase con la quale sarà visualizzato il risultato dell'operazione, oppure permette di omettere una parte del risultato (es. le unità di misura). Consultare il manuale per la descrizione delle opzioni. Valori suggeriti `b` `(o)` `br` `br()` `virgola` `numero` `o` `risultato` `valore risultato` `preunità` `quadre` `tabella` `tabellac` `unità` `unità2` `unità o testo` `x` Predefinito b	Sconosciuto	facoltativo

[1] adj è stato incluso solo per motivi di compatibilità con l'importazione del parametro da en.wiki, dato che può essere stato usato anche per alcune opzioni diverse dalla costruzione della forma aggettivata inglese.

[tab 1]