Utilisation

Le modele {{unite}} permet d’ecrire facilement et de typographier correctement un nombre ecrit en chiffres arabes ou romains suivi d’une unite ou d’un nom ^{[ 1 ]} . Par rapport a une ecriture directe, ses avantages sont :

• empecher le retour a la ligne entre le nombre et l’unite ou le nom correspondant, par l’insertion d’une espace insecable , comme dans ≪ 30  km  ≫ ou ≪ 1 500 habitants ≫ ;
• faciliter l’ecriture des exposants et des unites multiples, comme dans ≪  10   m s ^?1  ≫ ;
• faciliter les traductions d’articles lors d’import de valeurs (il suffit de modifier le nom du modele) en affichant le nombre selon le format local ;
• mettre en forme le nombre automatiquement, en groupant les chiffres par groupes de trois, comme dans ≪ 30 000 habitants ≫. Note : dans certains cas, la redirection {{nombre}} peut paraitre preferable d’un point de vue semantique , exemple : {{nombre|250000 deportes}} ;
• mettre en forme automatiquement les nombres en notation scientifique , comme dans ≪ 5 ×?10 ⁸  ≫ ;
• ajouter une infobulle sur les unites.

Dans le cas d’un nombre ≪ simple ≫ suivi d'un nom , utiliser de preference le modele {{nobr}} . Il ne gere que les nombres sans mise en forme particuliere (en particulier, sans separateurs de milliers ni decimaux), mais est plus econome en ressources consommees par le serveur.

Dans le cas d’un nombre ≪ simple ≫ seul (et uniquement dans ce cas), utiliser le mot magique {{formatnum:}} , qui demande moins de ressources au serveur. Utilise avec des nombres plus ≪ complexes ≫, il impose d'adopter un hybride de typographie anglo-saxonne ( separateurs decimal et de milliers ). En particulier, dans le cas d’un nombre suivi d’une partie decimale (comprenant des chiffres apres la virgule), il prend le point comme separateur decimal (au lieu de la virgule) et ne peut afficher correctement que trois chiffres de la partie decimale ( ex. : {{formatnum:3.141592}}), ce qui n’est pas le cas de {{unite}} (voir : ≪  Wikipedia:Conventions typographiques#Nombres et espaces  ≫ et ≪  Formatage de formatnum:  ≫).

Dans le cas des ecritures fractionnaires (barre de fraction en argument du modele), le modele ne respecte pas les conventions concernant les nombres sur Wikipedia .

Syntaxe

Deux syntaxes sont possibles, mais il ne faut pas les melanger.

Syntaxe distinguant chacun des parametres

• Syntaxe simple (un nombre) :

  {{Unite| nombre | unite 1 | exposant 1 | unite 2 | exposant 2 | unite 3 | exposant 3 | unite 4 | exposant 4 | unite 5 | exposant 5 }}

Un seul parametre est indispensable, nombre ou unite ₁ .

• Syntaxe plus complexe (deux nombres) :

  {{Unite| premier nombre |a= second nombre |et= second nombre |±= incertitude |e= puissance de 10 | unite 1 | exposant 1 | symbole 2 | unite 2 | symbole 3 | unite 3 | unite 4 | exposant 4 | unite 5 | exposant 5 }}

Les parametres a= (pour une plage de valeurs) et et= (pour une paire de valeurs) sont facultatifs mais mutuellement exclusifs. Les parametres ±= , e= ainsi que les unites et les exposants sont facultatifs.

Syntaxe a un parametre global

• {{Unite| nombre 1 a/et nombre 2 ± incertitude e puissance-de-10 unite 1 exposant 1 unite 2 exposant 2 unite 3 exposant 3 unite 4 exposant 4 unite 5 exposant 5 }}

Le terme ≪ a/et ≫ est a remplacer par a (plage de valeurs) ou et (paire de valeurs). Il faut au moins indiquer nombre 1 , ± incertitude ou unite 1  ; a cette exigence pres, nombre 1 , les groupes a/et nombre 2 , ± incertitude et e puissance-de-10 ainsi que les unites et leurs exposants sont tous facultatifs.

Le modele interprete aussi correctement le signe de fraction, par exemple g/cm3 pour ≪  g/cm ³  ≫ (gramme par centimetre cube).

Cette possibilite ne permet pas de gerer certains cas complexes, souvent des detournements du modele, tels que plusieurs nombres separes par du texte dans un seul modele, par exemple ≪ 1,23 jusqu’a 2,32  m ²  ≫, ou des nombres ou exposants contenant des lettres (des variables mathematiques), par exemple ≪ 2,5y  e ²ⁱ  ≫.

Parametres

Le modele peut prendre jusqu’a neuf parametres numerotes et un parametre nomme :

Parametre	Description	Type	note
1=	Valeur a afficher	Facultatif
a=	Seconde valeur de la plage a afficher	Facultatif
?=	Seconde valeur de la plage a afficher	Facultatif	Demi-cadratin.
et=	Seconde valeur a afficher	Facultatif
ou=	Seconde valeur a afficher	Facultatif
/=	Seconde valeur a afficher	Facultatif
×=	Deuxieme valeur de la dimension	Facultatif
××=	Troisieme valeur de la dimension	Facultatif
±=	Incertitude	Facultatif
+=	Incertitude + si la plage n’est pas symetrique	Facultatif
?=	Incertitude ? si la plage n’est pas symetrique	Facultatif	Signe moins.
e=	Puissance de 10 a afficher	Facultatif
2=	Premier symbole	Facultatif
3=	Exposant du premier symbole	Facultatif
4=	Deuxieme symbole	Facultatif
5=	Exposant du deuxieme symbole	Facultatif
6=	Troisieme symbole	Facultatif
7=	Exposant du troisieme symbole	Facultatif
8=	Quatrieme symbole	Facultatif
9=	Exposant du quatrieme symbole	Facultatif
10=	Cinquieme symbole	Facultatif
11=	Exposant du cinquieme symbole	Facultatif
fraction=	Fraction a afficher apres le nombre	Facultatif
arrondi=	Arrondit la valeur apres ce nombre de decimale	Facultatif	Peut etre negatif.
decimales=	Affiche exactement ce nombre de decimales	Facultatif.
basique=	Desactive la syntaxe en un seul parametre et les analyses sur le deuxieme parametre	Facultatif	Principalement destine aux infobox.

Une unite complexe peut etre specifiee a l’aide d’un parametre seul ou decomposee sous la forme d’une liste symbole|exposant . On peut omettre l’exposant (quand il vaut 1), en laissant simplement son champ vide. Le modele accepte jusqu'a cinq symboles accompagnes chacun d'un exposant.

Le modele reconnait aussi bien le point que la virgule comme separateur decimal, par exemple :

• ≪  {{Unite|2,3|g}}  ≫ affiche ≪ 2,3  g  ≫ ;
• ≪  {{Unite|2.3|g}}  ≫ affiche ≪ 2,3  g  ≫ ;
• ≪  {{Unite|1002,3|km}}  ≫ affiche ≪ 1 002,3  km  ≫ ;
• ≪  {{Unite|1002.3|km}}  ≫ affiche ≪ 1 002,3  km  ≫ ;
• ≪  {{Unite|1,002.3|km}}  ≫ affiche ≪ 1 002,3  km  ≫ ;
• ≪  {{Unite|1 002.3|km}}  ≫ affiche ≪ 1 002,3  km  ≫ ;
• ≪  {{Unite|1234567890.12345678|¤}}  ≫ affiche ≪ 1 234 567 890,123 456 78 ¤ ≫ ;
• ≪  {{Unite|1.002,3|km}}  ≫ affiche ≪ 1,002 3  km  ≫ pour etre compatible avec les limites precedentes du modele, mais cette syntaxe est deconseillee car non conforme aux conventions typographiques .

La syntaxe a un parametre simplifie la saisie :

• {{Unite|1,23 ± 0,02 e-3 m/s2}} affiche ≪ (1,23 ± 0,02) ×?10 ^?3   m/s ²  ≫.

Exemples d'utilisation

Syntaxe	Resultat	Commentaire
{{Unite|1234567}} {{Unite|1234567,89}} {{Unite|1,23456789|e=15}} {{Unite|1,23456789e15}}	1 234 567 1 234 567,89 1,234 567 89 ×?10 15 1,234 567 89 ×?10 15	Pour un nombre seul, la difference avec formatnum est qu’il est possible d’utiliser la virgule comme separateur decimal, les decimales sont groupees par 3 (a partir de 5 decimales) et les puissances de 10 sont correctement affichees.
{{Unite|10000|km}} {{Unite|10000 km}}	10 000  km 10 000  km	Cas d’utilisation simple : une valeur suivie d’un symbole.
{{Unite|10000|km|2}} {{Unite|10000|m|3}} {{Unite|10000 m3}}	10 000  km 2 10 000  m 3 10 000  m 3	Cas d’utilisation pour une unite avec un exposant .
{{Unite|10000|kilometres par heure}} {{Unite|10000 kilometres par heure}}	10 000  kilometres par heure 10 000  kilometres par heure	Il est possible d'ecrire l'unite en toutes lettres.
{{Unite|10000|km||h|-1}} {{Unite|10000|km||/h}} {{Unite|10000 km h-1}} {{Unite|10000 km/h}}	10 000   km h ?1 10 000   km/h 10 000   km h ?1 10 000   km/h	Deux symboles successifs, le second avec un exposant.
{{Unite|10000|J|2|K|3|s|-1}} {{Unite|10000 J2K3s-1}}	10 000  J 2  K 3  s ?1 10 000  J 2  K 3  s ?1	Trois symboles avec des exposants specifiques.
{{Unite|10000|J||kg||m|-2}} {{Unite|10000 J kg m-2}}	10 000  J kg m ?2 10 000  J kg m ?2	Trois symboles, les deux premiers ne possedant pas d’exposant. Dans la syntaxe en un seul parametre, chaque unite doit etre separee par une espace.
{{Unite|?40.234|°C}}	?40,234   °C	Cas mettant en evidence l’utilisation de la notation anglo-saxonne dans le premier parametre, lequel est affiche selon les conventions francophones.
{{Unite|1.23456|e=9|J|2|K|3|s|-1}} {{Unite|1,23456 e9 J2 K3 s-1}}	1,234 56 ×?10 9   J 2  K 3  s ?1 1,234 56 ×?10 9   J 2  K 3  s ?1	Trois symboles avec des exposants specifiques, mettant en evidence l’utilisation de la notation anglo-saxonne, ainsi que l’usage de puissances de 10 (usage scientifique) dans le parametre nomme  e , formate a l’aide du modele {{x10}} .
{{Unite|1|[[metre carre|m{{exp|2}}]]}} {{Unite|1|[[metre carre|m]]|2}}	1  m 2 1  m 2	Il est aussi possible de placer un lien vers les unites.
{{unite|e-1 m}} {{unite|10{{exp|?1}}|m}} {{unite|10{{-1}}|m}}	10 ?1   m 10 ?1   m 10 ?1   m	Affichage d’une puissance de 10 suivie d’un symbole, au moyen du modele {{exp}} . Pour cet exemple, le modele {{-1}} , plus pratique, donne le meme resultat.
{{Unite|1235 ±20 m}} {{Unite|1235 +20 -10 m}} {{Unite|1,235 ±0.02 e3 m}}	1 235 ± 20  m 1 235 +20 ?10   m (1,235 ± 0,02) ×?10 3   m	Une incertitude peut-etre ajoutee. Dans le cas de la notation avec des puissances de 10, des parentheses sont ajoutees pour clarifier la portee de cette puissance, mais elles ne sont pas prises en charge dans le parametre.
{{Unite|1200 a 1300 m}} {{Unite|1200 ? 1300 m}} {{Unite|1200 et 1300 m}} {{Unite|1200 / 1300 m}} {{Unite|1200 × 600 m}} {{Unite|12×6×2,3 cm}} {{Unite|12|×=6|××=2,3|cm}}	1 200 a 1 300  m 1 200?1 300  m 1 200 et 1 300  m 1 200 / 1 300  m 1 200 × 600  m 12 × 6 × 2,3  cm 12 × 6 × 2,3  cm	Il est possible de relier plusieurs nombres avec quelques mots cle. Pour les surfaces ou volumes, les ≪ x ≫ et les ≪ * ≫ sont acceptes dans la syntaxe en un parametre, et toujours affiches par ≪ × ≫. En cas d’utilisation avec des parametres separes, seul le ≪ × ≫ est accepte, et il faut le doubler pour la troisieme dimension. On peut aussi, plus simplement, recourir aux modeles {{dunite}} et {{tunite}} , respectivement pour deux et trois valeurs ayant une meme unite.
{{Unite|16 2/3 Hz}} {{Unite|1/2 lb}}	16 ²?₃  Hz ¹?₂  lb	Fraction pour eviter une approximation ou etre plus proche de l’expression courante. Ne pas mettre d’espace entre les chiffres et la barre de fraction, sinon c’est interprete comme deux nombres separes par une barre oblique (parametre / )
{{Unite|1.23456|m|arrondi=3}} {{Unite|1.23456|m|arrondi=6}} {{Unite|123456|m|arrondi=-2}} {{Unite|1.23456 e5 m|arrondi=3}} {{Unite|1.23456|m|decimales=3}} {{Unite|1.23456|m|decimales=6}}	1,235  m 1,234 56  m 123 500  m 1,235 ×?10 5   m 1,235  m 1,234 560  m	Les resultats d’un calcul automatique peuvent etre arrondis ou affiches avec un nombre fixe de decimales.

Cas particuliers

Pour les nombres sans mise en forme particuliere et suivis d'un nom, utiliser de preference le modele {{nobr}} , plus simple. Pour typographier les nombres seuls, n’etant pas en notation scientifique, ne comportant que trois chiffres decimaux au plus, et non suivis d'une unite ou d’un nom, le mot magique ≪  {{formatnum: nombre }}  ≫ est suffisant.

Dans quels cas ne pas utiliser ce modele ?

Resultat identique pour un code wiki beaucoup plus simple a editer sans modele

Code wiki	Rendu HTML
{{Unite|20|%}}	20   %
20 %	20   %
20 %	20   %

Cas particuliers de %

Ce modele est inutile et deconseille lorsque l’unite est le ≪  pour cent  ≫. Cela complique l’edition et la lecture du code wiki pour un resultat identique. Il suffit d’inserer une espace simple car, dans ce cas particulier, l’espace insecable est automatiquement geree par MediaWiki , voir les conventions typographiques .

Note : en revanche, ce modele doit etre utilise lorsque l’unite est le ≪  pour mille  ≫. {{Unite|5|‰}} aura pour rendu : 5  ‰ .

Unites sexagesimales d'angle et degre d'alcool

Dans le cas des unites sexagesimales d’angle (mesure d’angle, latitude, longitude) et du degre d’alcool , le symbole d’unite ne doit pas etre detache du nombre. Il ne faut donc pas utiliser ce modele.

On ecrira donc simplement : ≪ un angle de 30° ≫, ≪ un vin titrant 11° ≫.

Dans le cas de coordonnees composees, il est souhaitable d’utiliser le modele {{nobr}}  : {{nobr|35° 19′ 20″}} de latitude N qui donne : 35° 19′ 20″ de latitude N.

Symbole ≪ a ≫

Le symbole ≪ a ≫ est celui de l' are ou d' annum (annee julienne).

• ≪  {{Unite|123 a}}  ≫ affiche ≪ 123  a  ≫ avec l' infobulle ≪ are ≫.
• ≪  {{Unite|3 cm/an}}  ≫ affiche ≪ 3  cm/an  ≫ avec l'infobulle ≪ centimetre par an ≫.

Les multiples et sous-multiples usuels sont geres correctement (absence d'ambiguite, en pratique) : ca et ha (qui concernent l'are), ka , Ma et Ga (qui concernent l'annum).

Terme ≪ F ≫

• ≪  F  ≫ est le symbole du farad .

≪  {{Unite|123 F}}  ≫ affiche ≪ 123  F  ≫ avec l'infobulle ≪ farad ≫.

• ≪  F  ≫ est aussi l'abreviation courante des unites monetaires (actuelles ou anciennes) portant le nom de ≪  franc  ≫ ( ex. : franc suisse , franc CFA , franc Pacifique , franc francais ).

Symboles ≪ N m ≫, ≪ Nm ³  ≫ et ≪ Nm ≫

• ≪  {{Unite|123 N m}}  ≫ affiche ≪ 123  N m  ≫ avec l'infobulle ≪  newton metre  ≫.
• ≪  {{Unite|123 Nm3}}  ≫ affiche ≪ 123  Nm ³  ≫ avec l'infobulle ≪  normo metre cube  ≫.
  • ≪  {{Unite|123 Nm}}  ≫ affiche ≪ 123  Nm  ≫ avec l'infobulle ≪ normo metre ≫.

Symbole ≪ MN ≫

• ≪  {{Unite|123 MN}}  ≫ affiche ≪ 123  MN  ≫ avec l'infobulle ≪  meganewton  ≫.
• ≪ MN ≫ est aussi le symbole du mille marin .

Symbole ≪ b ≫

• ≪  {{Unite|64 b}}  ≫ affiche ≪ 64  b  ≫ avec l'infobulle ≪  bit  ≫.
• ≪ b ≫ est aussi le symbole du barn .

Texte alternatif pour les images

MediaWiki retire automatiquement les balises HTML/CSS indesirables qui sont dans le parametre |alt= pour etre conforme aux normes W3C, ajouter le modele {{unite}} n’est donc pas utile et n’aura aucun effet.

Notes et references

TemplateData

Met en forme un nombre et son unite, en ajoutant automatiquement des separateurs de milliers (espaces), une infobulle sur les eventuels symboles, et empeche tout retour a la ligne entre le nombre et son unite.

Parametres du modele [ Modifier les donnees du modele ]

La mise en forme sur une seule ligne est preferee pour ce modele.

Parametre		Description	Type	Etat
Valeur	1	Valeur a afficher. L'unite peut etre saisie directement a la suite, ou alors etre saisie dans le champ ≪ Unite ≫. Exemple ≪ 12,34 ≫ ou ≪ 12,34 kg ≫	Ligne de texte	obligatoire
a	a	Permet d'indiquer un intervalle avec la conjonction ≪ a ≫. Exemple 15,36	Nombre	facultatif
ou	ou	Permet d’indiquer un deuxieme nombre avec la conjonction ≪ ou ≫. Exemple 15,36	Nombre	facultatif
et	et	Permet d’indiquer un deuxieme nombre avec la conjonction ≪ et ≫. Exemple 15,36	Nombre	facultatif
?	? -	Permet d'indiquer un intervalle a l'aide d'un tiret demi?cadratin. Exemple 15,36	Nombre	facultatif
/	/	Permet d’indiquer un deuxieme nombre clairement separe par ≪ / ≫. Notamment utilise dans les infobox pour separer deux series de nombres. Exemple 15,36	Nombre	facultatif
×	× x	Permet d’indiquer un deuxieme nombre separe par un signe multiplier, par exemple pour une surface. Exemple 29,7	Nombre	facultatif
××	××	Permet d’indiquer un troisieme nombre separe par un signe multiplier, par exemple pour un volume. Exemple 3	Nombre	facultatif
Exposant	e	Puissance de 10 a afficher. Exemple 9 pour la valeur ≪ 4,5×10^9  ≫.	Nombre	facultatif
Unite	2	Indiquer la premiere unite sous forme de symbole ou en toutes lettres. L'unite peut egalement etre indiquee dans le champ ≪ Valeur ≫ au lieu de l'indiquer ici. Exemple ≪ kg ≫, ≪ kilogrammes ≫	Ligne de texte	suggere
Premier exposant	3	Exposant du premier symbole. Exemple 2 pour l’unite ≪ metre carre ≫.	Nombre	facultatif
Deuxieme symbole	4	aucune description Exemple s pour l’unite ≪ metre par seconde carre ≫.	Ligne de texte	facultatif
Deuxieme exposant	5	Exposant du deuxieme symbole. Exemple -2 pour l’unite ≪ metre par seconde carre ≫.	Nombre	facultatif
Troisieme symbole	6	aucune description	Ligne de texte	facultatif
Troisieme Exposant	7	Exposant du troisieme symbole.	Nombre	facultatif
Quatrieme symbole	8	aucune description	Ligne de texte	facultatif
Quatrieme exposant	9	Exposant du quatrieme symbole.	Nombre	facultatif
Cinquieme symbole	10	aucune description	Ligne de texte	facultatif
Cinquieme exposant	11	Exposant du cinquieme symbole.	Nombre	facultatif
±	± +- +/-	Incertitude. Exemple 0,05	Nombre	facultatif
+	+	Incertitude positive, si la valeur est differente de l’incertitude negative. Exemple 0,2	Nombre	facultatif
?	?	Incertitude negative, si la valeur est differente de l’incertitude positive. Exemple 0,1	Nombre	facultatif
arrondi	arrondi	Nombre maximal de decimales affichees. Exemple 2	Nombre	facultatif
decimales	decimales	Nombre de decimales affichees. Exemple 2	Nombre	facultatif
fraction	fraction	fraction a afficher apres l’eventuel nombre. Exemple 2/3	Ligne de texte	facultatif
M	M	Masse molaire, destinee a afficher en infobulle une conversion de g/cm³ en m³/mol ou de kJ/mol en kJ/g Exemple 26.0373	Nombre	facultatif
basique	basique	Desactive la syntaxe en un seul parametre. Principalement destine aux infobox. Par defaut non	Booleen	facultatif

Correspondance interwiki

La Wikipedia anglophone n’a pas de modele identique, mais utilise un modele similaire, ≪  val  ≫, qui permet d’indiquer un intervalle approximatif et une unite de mesure.

Ne pas utiliser la version francophone {{val}} , mais plutot ce modele {{unite}} .

Voir aussi

• {{unite/2}} qui offre plus de possibilites (conversions, approximations, intervalles)
• {{Temperature}} qui permet de mettre en forme une temperature
• {{λ}} qui permet de formater les longueurs d’onde
• {{Monnaie}} qui permet de formater les devises
• {{Dunite}} qui sert a indiquer les deux dimensions d’un objet rectangulaire, par exemple d’une peinture
• {{Tunite}} qui sert a indiquer les trois dimensions d’un objet parallelepipedique, par exemple d’une tombe
• Aide:Syntaxe#Les nombres
• Wikipedia:Conventions concernant les nombres
• Espace insecable , obtenue par ≪   ≫ dans MediaWiki ? eviter la rupture de ligne sur une espace .
• {{x10}} ? notation scientifique avec puissance de 10.
• {{exp}} ? mettre en exposant .
• {{nobr}} ? eviter une rupture d’une ligne dans une expression.
• Aide de ≪ formatnum ≫, sur Meta .
• Categorie:Page incorrectement traitee par le Module:Unite