Modèle:Unité/2/Documentation

Le modèle {{unité/2}} permet d’écrire facilement et de typographier correctement un nombre écrit en chiffres arabes ou romains suivi d’une unité ou d’un nom. Par rapport à une écriture directe, il présente les mêmes avantages que le modèle {{unité}}, à savoir :

• mettre automatiquement en forme le nombre, en groupant les chiffres par trois, comme dans « 30 000 âmes » (cependant, dans le cas d'un nombre sans unité ni suivi d'un nom, il est préférable d'utiliser le code {{formatnum:}}) ;
• éviter un retour à la ligne entre le nombre et l’unité ou le nom correspondant, comme dans « 30 km » ou « 250 habitants » en fin de ligne ;
• faciliter l’écriture des exposants et des unités multiples, comme dans « 10 m·s^-1 » ;
• faciliter le copier-coller de valeurs d'une langue à une autre (l'affichage s'adapte aux conventions locales, il suffit de changer le nom du modèle) en particulier lors de la traduction d'un article entre français et anglais ;
• associer deux valeurs à une unité, comme dans « 10 à 31 m » ;
• afficher des intervalles de tolérance, comme dans 100⁺⁵₋₄ mm.

Mais ce modèle permet d'obtenir un affichage plus élaboré que le modèle {{unité}} :

• afficher des informations complémentaires complexes au passage de la souris sur la valeur. Pour voir, positionner le pointeur sur le « 1,82 » de l'expression 1,82 g·cm^-3

Syntaxe

• {{Unité/2|nombre|unité1|exposant1|unité2|exposant2|unité3|exposant3|unité4|exposant4}}
• {{Unité/2|nombre|e=puissance de 10|unité1|exposant1|symbole2|unité2|symbole3|unité3|unité4|exposant4}}

Paramètres

Le modèle peut prendre jusqu’à neuf paramètres numéroté et un paramètre nommé :

Paramètre	Description	Type
1=	Valeur à afficher	Obligatoire
e=	Puissance de 10 à afficher	Facultatif
2=	Premier symbole	Facultatif
3=	Exposant du premier symbole	Facultatif
4=	Deuxième symbole	Facultatif
5=	Exposant du deuxième symbole	Facultatif
6=	Troisième symbole	Facultatif
7=	Exposant du troisième symbole	Facultatif
8=	Quatrième symbole	Facultatif
9=	Exposant du quatrième symbole	Facultatif

Il est possible de spécifier une unité complexe à l'aide d'un paramètre seul ou de la décomposer sous la forme d’une liste symbole|exposant. Il est aussi possible de ne pas mettre d’exposant (quand il vaut 1), pour cela, il suffit de laisser celui-ci vide. Au maximum, il est possible d’afficher quatre symboles possédant chacun un exposant.

Attention

Le premier paramètre, celui de la valeur à afficher, est mis en forme à l’aide du mot magique {{formatnum:}}. Par conséquent :

• il faut utiliser le point comme séparateur décimal (convention informatique et anglo-saxonne), et non la virgule, dans le paramètre transmis au modèle. Le modèle affichera automatiquement le nombre suivant les conventions francophones ;
• le mot magique ne sait pas convertir les notations scientifiques exponentielles (ne pas utiliser le symbole e avant l’exposant entier) ; on placera l’exposant entier dans le paramètre nommé e ;
• il ne faut pas insérer d’espace ou d’apostrophe pour séparer les milliers : ils sont automatiquement ajoutés par le modèle selon les conventions locales (sous forme d’espace insécable en français), sauf pour la partie décimale, où, pour respecter le typographie recommandée, il est préférable de placer des espaces simples par groupes de trois chiffres ;
• il est cependant possible de grouper les chiffres autrement que par trois, en insérant explicitement une virgule comme séparateur (convention anglo-saxonne), laquelle sera transformée en espace (insécable) par le modèle.

Exemples :

• « {{Unité/2|2,3|g}} » affiche « 2,3 g », ce qui n’est sans doute pas le résultat attendu ;
• entrer « {{Unité/2|2.3|g}} » pour afficher « 2,3 g » ;
• entrer « {{Unité/2|1002.3|km}} » pour afficher « 1 002,3 km » , etc.

Exemples d’utilisation

Syntaxe identique à {{unité}}

Syntaxe	Résultat	Commentaire
{{Unité/2|1234567}} {{Unité/2|1234567.89}} {{Unité/2|1.23456789|e=15}}	1 234 567 1 234 567,89 1,234 567 89×1015	Non conseillé : préférer l'utilisation du modèle spécial {{formatnum:}}. Cas d’utilisation minimale : une valeur seule (sans unité), éventuellement avec usage de puissances de 10 (usage scientifique) dans le paramètre nommé e, formaté à l’aide du modèle {{x10}}.
{{Unité/2|10000|km}} {{Unité/2|10000|km/h}}	10 000 km 10 000 km/h	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Cas d’utilisation simple  : une valeur suivie d’un symbole.
{{Unité/2|10000|km|2}} {{Unité/2|10000|m|3}}	10 000 km2 10 000 m3	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Cas d'utilisation pour une unité avec un exposant.
{{Unité/2|10000|kilomètres par heure}}	10 000 kilomètres par heure	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Affichage indésirable possible. Il est possible d’écrire l’unité en toutes lettres. Dans ce cas il n’est cependant pas strictement nécessaire d’empêcher une rupture de ligne entre le nombre et l’unité complète, seul le premier terme doit être lié au nombre, ici « {{Unité|10000|kilomètres}} par heure ». Notez bien que le modèle {{Unité}} (tel {{nobr}}) empêche les ruptures de ligne dans toute l’expression « 10 000 kilomètres par heure ».
{{Unité/2|10000|J|2|K|3|s|-1}}	10 000 J2·K3·s-1	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Trois symboles avec des exposants spécifiques.
{{Unité/2|10000|J||kg||m|-2}}	10 000 J·kg·m-2	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Trois symboles, les deux premiers ne possédant pas d’exposant.
{{Unité/2|-40.234|°C}}	−40,234 °C	Non conseillé : préférer l'utilisation du modèle {{température}} Cas mettant en évidence l’utilisation de la notation anglo-saxonne dans le premier paramètre, lequel est affiché selon les conventions francophones.
{{Unité/2|1.23456|e=9|J|2|K|3|s|-1}}	1,234 56×109 J2·K3·s-1	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Trois symboles avec des exposants spécifiques, mettant en évidence l’utilisation de la notation anglo-saxonne, ainsi que l’usage de puissances de 10 (usage scientifique) dans le paramètre nommé e, formaté à l’aide du modèle {{x10}}.
{{Unité/2|1|[[kilomètre carré|km{{exp|2}}]]}}	1 km2	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Il est aussi possible de placer un lien vers les unités.
{{unité/2|10{{exp|−1}}|m}} {{unité/2|10{{-1}}|m}}	10−1 m 10−1 m	Non conseillé : préférer l'utilisation du modèle {{unité}}, plus simple. Affichage d’une puissance de 10 suivie d’un symbole, au moyen du modèle {{exp}}. Pour cet exemple, le modèle {{-1}}, plus pratique, donne le même résultat.

Syntaxe spécifique à {{unité/2}}

Syntaxe	Résultat	Commentaire
{{unité/2|55|à=56|cal}} {{unité/2|55|et=56|cal}} {{unité/2|55|ou=56|cal}} {{unité/2|2|puis=3|jours}} {{unité/2|55|–=56|cal}} {{unité/2|100|±=9|mm}}	55 à 56 cal 55 et 56 cal 55 ou 56 cal 2 puis 3 jours 55–56 cal 100 ± 9 mm	La syntaxe ne fonctionne qu'avec un de ces 6 paramètres. Pour l'étendre, voir la demande en pdd. Le caractère utilisé est le tiret demi-cadratin  « – » (U+2013).
{{unité/2|100|+=5|−=4|mm}}	100+5−4 mm	Le caractère utilisé est le signe moins « − » (U+2212) (fonctionne aussi avec le tiret « - »)
{{unité/2|18.23|g||l|-1|M=36.46}}	18,23 g·l-1	La concentration molaire s'affiche au passage de la souris sur la valeur.
{{unité/2|1.82|g||cm|-3|M=30.973762}}	1,82 g·cm-3	La masse volumique, le volume molaire et la concentration Baumé s'affichent au passage de la souris sur la valeur.

Dans quel cas ne pas utiliser ce modèle ?

Résultat identique pour un code wiki beaucoup plus simple à éditer sans modèle

Code wiki	Rendu HTML
{{Unité|20|%}}	20 %
20 %	20 %
20 %	20 %

Ce modèle est inutile lorsque l’unité est le pourcent. En principe, il faut placer une espace insécable entre un nombre et le caractère « % » qui le suit. Mais dans Wikipédia, une espace normale suffit, car le logiciel de rendu (MediaWiki) la transforme automatiquement en espace insécable à l’affichage de la page (analyser le code HTML pour s’en convaincre). De plus, c'est déconseillé, car cela complique l’édition et la lecture du code wiki pour un résultat identique.

En revanche, ce modèle doit être utilisé lorsque l’unité est le « pour mille ». {{Unité|5|‰}} aura pour rendu : 5 ‰.

Conversion d'unités

La conversion s'affiche au passage de la souris sur la valeur.

depuis	vers	syntaxe	résultat
a, an, ans, année, années	s	{{unité/2|1|an}}	1 an
Å	nm	{{unité/2|1|Å}}	1 Å
atm	kPa, bar	{{unité/2|1|atm}}	1 atm
bar, bars	kPa, bar	{{unité/2|1|bar}}	1 bar
CàC, càc	ml	{{unité/2|1|càc}}	1 càc
cal15	J	{{unité/2|1|cal15}}	1 cal15
cal20	J	{{unité/2|1|cal20}}	1 cal20
calIT	J	{{unité/2|1|calIT}}	1 calIT
cal	J	{{unité/2|1|cal}}	1 cal
calth	J	{{unité/2|1|calth}}	1 calth
carat, carats	mg	{{unité/2|1|carat}}	1 carat
CàS, càs	ml	{{unité/2|1|càs}}	1 càs
ch	m (voir la note)	{{unité/2|1|ch}}	1 ch
clo	m2·K·W-1	{{unité/2|1|clo}}	1 clo
C⋅m	D	{{unité/2|1|C||m}}	1 C·m
cmHg	kPa	{{unité/2|1|cmHg}}	1 cmHg
°C, ºC	°F, K	{{unité/2|1|°C}}	1 °C
cP	Pa·s	{{unité/2|1|cP}}	1 cP
cSt	m2·s-1	{{unité/2|1|cSt}}	1 cSt
D	C⋅m	{{unité/2|1|D}}	1 D
De, °De, ºDe	°C, °F, K	{{unité/2|1|°De}}	1 °De
erg	J	{{unité/2|1|erg}}	1 erg
eV	J, kJ·mol-1, nm	{{unité/2|1|eV}}	1 eV
faraday	C	{{unité/2|1|faraday}}	1 faraday
fermi, fermis	fm	{{unité/2|1|fermi}}	1 fermi
fl oz, floz, oz liq, fl. oz., oz. fl.	l	{{unité/2|1|fl oz}}	1 fl oz
°F, ºF	°C, K	{{unité/2|1|°F}}	1 °F
Fr, franklin	C	{{unité/2|1|Fr}}	1 Fr
Gal	m·s-2	{{unité/2|1|Gal}}	1 Gal
g⋅cm-3, gm⋅cm-3	kg⋅m-3	{{unité/2|1|g||cm|-3}}	1 g·cm-3
g⋅ml-1, gm⋅ml-1	kg⋅m-3	{{unité/2|1|g||ml|-1}}	1 g·ml-1
gon, gr, grade	rad, °	{{unité/2|1|gon}}	1 gon
grain, grains	mg	{{unité/2|1|grain}}	1 grain
Gs, G	T	{{unité/2|1|Gs}}	1 Gs
ha	m2 et km2	{{unité/2|1|ha}}	1 ha
hPa	mbar, atm	{{unité/2|1|hPa}}	1 hPa
h, hr, heure, heures	s	{{unité/2|1|h}}	1 h
j, jour, jours	s	{{unité/2|1|j}}	1 j
kcal15, Cal15	J	{{unité/2|1|kcal15}}	1 kcal15
kcal20, Cal20	J	{{unité/2|1|kcal20}}	1 kcal20
kcal, Cal	J	{{unité/2|1|kcal}}	1 kcal
kcalIT, CalIT	J	{{unité/2|1|kcalIT}}	1 kcalIT
kcalth, Calth	J	{{unité/2|1|kcalth}}	1 kcalth
K	°C, °F	{{unité/2|1|K}}	1 K
kgf	N	{{unité/2|1|kgf}}	1 kgf
kg·m-3	g⋅cm-3	{{unité/2|1|kg||m|-3}}	1 kg·m-3
kip	kN	{{unité/2|1|kip}}	1 kip
km·h-1	m·s-1, mph	{{unité/2|1|km||h|-1}}	1 km·h-1
kPa	bar, atm	{{unité/2|1|kPa}}	1 kPa
kp	N	{{unité/2|1|kp}}	1 kp
kW·h	MJ	{{unité/2|1|kW||h}}	1 kW·h
kWh	MJ	{{unité/2|1|kWh}}	1 kWh
lambert	cd·m-2	{{unité/2|1|lambert}}	1 lambert
l	m³, fl. oz.	{{unité/2|1|l}}	1 l
mbar	Pa	{{unité/2|1|mbar}}	1 mbar
%m	g·kg-1, ppm	{{unité/2|1|%m}}	1 %m
mho	S	{{unité/2|1|mho}}	1 mho
min, minute, minutes	s	{{unité/2|1|min}}	1 min
mmHg, mm Hg	Pa, bar, atm	{{unité/2|1|mmHg}}	1 mmHg
µ	µm	{{unité/2|1|µ}}	1 µ
MPa	bar, atm	{{unité/2|1|MPa}}	1 MPa
mph	km·h-1	{{unité/2|1|mph}}	1 mph
m·s-1	km·h-1, mph	{{unité/2|1|m||s|-1}}	1 m·s-1
Mx	Wb	{{unité/2|1|Mx}}	1 Mx
nit	cd·m-2	{{unité/2|1|nit}}	1 nit
nm	Å	{{unité/2|1|nm}}	1 nm
nox	lx	{{unité/2|1|nox}}	1 nox
Oe	A·m-1	{{unité/2|1|Oe}}	1 Oe
Pa	bar, atm	{{unité/2|1|Pa}}	1 Pa
pm	Å	{{unité/2|1|pm}}	1 pm
ppb	%	{{unité/2|1|ppb}}	1 ppb
%	ppm	{{unité/2|1|%}}	1 %
ppm	%	{{unité/2|1|ppm}}	1 ppm
ppq	%	{{unité/2|1|ppq}}	1 ppq
ppt	%	{{unité/2|1|ppt}}	1 ppt
psi	kPa	{{unité/2|1|psi}}	1 psi
°Ra, ºRa	°C, °F, K	{{unité/2|1|°Ra}}	1 °Ra
rad	grades	{{unité/2|1|rad}}	1 rad
rem	Sv	{{unité/2|1|rem}}	1 rem
Ré, °Ré, ºRé, Re, °Re	°C, °F, K	{{unité/2|1|°Ré}}	1 °Ré
rpm, tpm	rad·s-1	{{unité/2|1|rpm}}	1 rpm
r	rad	{{unité/2|1|r}}	1 r
s, seconde, secondes	j h min s	{{unité/2|100000|s}}	100 000 s
st	m3	{{unité/2|1|st}}	1 st
tasse, tasses, c	ml	{{unité/2|1|tasse}}	1 tasse
tep	GJ	{{unité/2|1|tep}}	1 tep
%vol	ml·l-1, ppm	{{unité/2|1|%vol}}	1 %vol
W·cm-2	W·m-2	{{unité/2|1|W||cm|-2}}	1 W·cm-2
W·h	J	{{unité/2|1|W||h}}	1 W·h
W·s	J	{{unité/2|1|W||s}}	1 W·s
yd	m	{{unité/2|1|yd}}	1 yd
γ	T	{{unité/2|1|γ}}	1 γ
Ω·cm	Ω·m	{{unité/2|1|Ω||cm}}	1 Ω·cm

Problème connu

Lorsque l’expression produite par le modèle {{Unité}} se trouve entre parenthèses, comme dans (1 309 m), certains navigateurs web permettent une rupture de ligne entre l’une des parenthèses et l’expression.

Voir aussi

• {{Unité}} : syntaxe simplifiée
• {{Température}} ou {{Tmp}} : pour afficher les équivalents en °F, K, etc. lorsque le curseur pointe sur la valeur
• {{Dunité}} : pour les surfaces
• {{Tunité}} : pour les volumes
• {{Monnaie}} : pour un lien wiki automatique sur la devise

Annexes

• Espace insécable, obtenue par «   » dans MediaWiki — éviter la rupture de ligne sur une espace.
• le modèle {{Monnaie}}
• {{nobr}} — éviter une rupture d’une ligne dans une expression.
• Aide de « formatnum » sur Meta.
• en:Category:Unit display : groupe de modèles à fonction équivalente, sur (en).