Voir la source de Modèle:Inflation/Documentation

Vous n’avez pas la permission de modifier cette page, pour la raison suivante :

Votre adresse IP fait partie d’une plage qui a été bloquée sur tous les wikis de la Fondation Wikimédia.

Le blocage a été effectué par ‪EPIC‬. Le motif invoqué est Open proxy/Webhost: See the help page if you are affected.

Début du blocage : 2 juillet 2024 à 09:48
Expiration du blocage : 2 juillet 2025 à 09:48

Votre adresse IP actuelle est 206.189.44.186. La plage bloquée est 206.189.32.0/20.

Veuillez inclure tous les détails ci-dessus dans toutes les demandes que vous effectuerez. Si vous pensez avoir été bloqué(e) par erreur, vous pouvez trouver plus d’informations et d’instructions dans la politique globale Pas de serveurs mandataires ouverts.

Sinon, pour discuter du blocage, veuillez publier une demande de révision sur Méta-Wiki. Vous pouvez également envoyer un courriel à la file des coordinateurs VRT à stewards@wikimedia.org, en incluant tous les détails ci-dessus.

Vous pouvez voir et copier le contenu de cette page.

{{Sous-page de documentation}}
{{Sommaire à droite}}

Ce modèle prend un code pays [[ISO 3166-1 alpha-2]], par exemple, "<code>US</code>" pour les [[États-Unis]] ou "<code>UK</code>" pour le [[Royaume-Uni]], une <code>valeur</code> dans la monnaie du pays, une <code>année de début</code>, et applique à cette valeur l'[[Indice des prix à la consommation]] jusqu'à l'année en cours ou une autre <code>année de fin</code><ref>La date de mise à jour dépend de la façon dont l'ensemble de données pour chaque pays est construit et des tableaux internes mis à jour en conséquence chaque janvier. Certains tableaux de données fournissent des données sur l'inflation jusqu'au 31 décembre {{#expr:{{CURRENTYEAR}}-1}}, d'autres jusqu'à environ juin-juillet {{#expr:{{CURRENTYEAR}}-1}}, et d'autres encore jusqu'au 31 décembre {{#expr:{{CURRENTYEAR}}-2}}.</ref>. Par exemple, ce modèle appelle la table d'inflation (une table de données) de U.S. située dans une page de sous-modèle [[Modèle:Inflation/US/table de données]] pour effectuer le calcul d'inflation de U.S. Cela signifie qu'à chaque fois qu'une nouvelle année d'inflation arrive, les tables d'inflation doivent être actualisées pour que tous les articles utilisant ce modèle aient leurs valeurs affichées en conséquence de cette mise à jour.

Alternativement, vous pouvez fournir un deuxième paramètre facultatif <code>end_year</code>, et la valeur sera gonflée pour la période entre les deux années, offrant un moyen pratique d'obtenir des valeurs de différentes périodes ajustées autour de la même date.

== Utilisation ==
 {{tlx|Inflation|code_pays|montant|année_début}}
 {{tlx|Inflation|code_pays|montant|année_début|année_fin}}
 {{tlx|Inflation|code_pays|montant|année_début|année_fin|r{{=}}digit}}
 {{tlx|Inflation|code_pays|montant|année_début|r{{=}}digit|fmt{{=}}c}}
 {{tlx|Inflation|code_pays|montant|année_début|r{{=}}digit|fmt{{=}}eq}}
 {{tlx|Inflation|code_pays|montant|année_début|r{{=}}digit|fmt{{=}}eq|cursign{{=}}X}}

Les pays pris en charge sont listés ci-dessous, avec le '''code_pays''' et l''''année_début''' minimale:

{|class="wikitable sortable" style="text-align:center;"
!scope="col"| ''Nom du pays'' !!scope="col"| <code>code_pays</code> !!scope="col"| <code>année_début</code> minimale !!scope="col"| dernière mise à jour
|-
!scope="row"| [[Australie]]{{Inflation-info|AU}}
| '''AU''' || 1901 || 2010
|-
!scope="row"| [[Allemagne]]{{Inflation-info|DE}}
| '''DE''' || 1882 || 2009
|-
!scope="row"| [[Belgique]]{{Inflation-info|BE}}
| '''BE''' || 1399 || 2020
|-
!scope="row"| [[Canada]]{{Inflation-info|CA}}
| '''CA''' || 1916 || 2018
|-
!scope="row"| [[États-Unis]]{{Inflation-info|US}}
| '''US''' || 1800 || 2019
|-
!scope="row"| [[France]]{{Inflation-info|FR}}
| '''FR''' || 1901 || 2019
|-
!scope="row"| [[Japon]]{{Inflation-info|JP}}
| '''JP''' || 1946 || 2013
|-
!scope="row"| [[Royaume-Uni]]{{Inflation-info|UK}}
| '''UK''' || 1264 || 2019
|-
!scope="row"| [[Suisse]]{{Inflation-info|CH}}
| '''CH''' || 1501 || 2021
|}

== Paramètres ==
* '''code_pays''' (paramètre 1) peut être: AU, CA, DE, FR, UK, US, UKNGDPPC, etc.
* '''montant''' (paramètre 2) peut être un chiffre à virgule, mais aucun signe de devise (€, $, £, etc).
* '''année_début''' (paramètre 3) dépend des années de chaque pays.
* '''année_fin''' (paramètre 4), si indiquée, l'année doit être plus grande (plus tard) que '''année_début''', mais inférieure à l'année actuelle qui est la valeur par défaut.
* '''r='''''chiffre'' indique comment la valeur doit être arrondie, par défaut "0", arrondi au chiffre entier le plus proche (voir [[#Arrondi (paramètre r)]] ci-dessous pour les détails d'utilisation de ce paramètre).
* '''fmt=c''' insérera des virgules dans la valeur gonflée.
* '''fmt=eq''' affichera une phrase ''équivalente à''.
* '''cursign=X''' définira le signe monétaire lorsque 'fmt=eq' est utilisé (par défaut : $).

=== Arrondi (paramètre <code>r</code>) ===
Par défaut, les valeurs sont arrondies à l'entier le plus proche, ceci en raison que les décimales ne sont pas très utiles pour les grandes valeurs. Si vous avez besoin de plus de précision, vous pouvez utiliser le paramètre <code>r</code> pour déterminer la façon dont l'arrondi doit se faire. Pour obtenir les décimales, vous devez attribuer au paramètre <code>r</code> un chiffre positif; pour arrondir par excès à la dizaine, centaine, millier, etc, valeur la plus proche, vous devez attribuer un chiffre négatif.

== Conversion de devises ==
Ce modèle est indépendant de la devise, ce qui signifie qu'il ne convertit pas entre différentes devises. Ainsi, si vous vouliez savoir combien valent aujourd'hui 1 000,00 [[Franc français|FRF]] en 1960, entrer {{tlx|Inflation|FR|1000|1960|r{{=}}2}} donnerait un résultat ({{Inflation|FR|1000|1960|r=2}}) toujours en francs, pas en euros.

Par conséquent, si vous avez besoin d'un résultat dans une autre devise que celle dans laquelle la valeur d'origine est indiquée, vous devez pour l'instant effectuer la conversion manuellement, comme dans l'exemple suivant qui utilise le taux de conversion défini de 1&nbsp;€ = FR 6,56 :

* <code><nowiki>{{#expr:</nowiki>({{tlx|Inflation|FR|1000|1960|r{{=}}2}}<nowiki> / 6.56) round 2}}</nowiki></code> = {{#expr:({{Inflation|FR|1000|1960|r=2}} / 6.56) round 2}}

Un modèle de conversion de devise pour faciliter ces tâches de conversion est prévu. Cette section sera mise à jour en conséquence une fois qu'elle sera développée.

== Formater la valeur retournée ==
Pour une meilleure représentation des nombres, vous pouvez utiliser le [[Aide:Liste des modèles spéciaux|modèle spécial]] <code><nowiki>{{</nowiki>[[Aide:Liste_des_modèles_spéciaux#Manipulation_de_texte_et_formatage|formatnum:]]<nowiki>}}</nowiki></code>.

<code><nowiki>{{</nowiki>[[Aide:Liste_des_modèles_spéciaux#Manipulation_de_texte_et_formatage|formatnum:]]<nowiki>}}</nowiki></code> est la méthode standard pour formater des nombres dans MediaWiki. Elle ajoute des séparateurs entre les milliers et les décimales en fonction de la configuration de l'utilisateur, et fonctionne correctement avec des nombres composés de 15 chiffres maximum et un point comme séparateur de décimales. Cependant, elle ne permet pas d'agir sur le nombre de décimales affichées après le point. Ainsi, la valeur "1234.5" apparaîtra "{{formatnum:{{#expr:1000 + 234.5}}}}", et non la valeur attendue "1 234,50" si l'on souhaitait indiquer le prix d'un article, avec deux chiffres décimaux.
* <code>'''DM''' <nowiki>{{formatnum:</nowiki>{{tlx|Inflation|DE|1000000|1957|1978}}<nowiki>}}</nowiki>'''.00'''</code> = DM {{formatnum:{{Inflation|DE|1000000|1957|1978}}}}.00
* <code>'''£'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|UK|1000000|1323|1978|r{{=}}-4}}<nowiki>}}</nowiki></code> = £{{formatnum:{{Inflation|UK|1000000|1323|1978|r=-4}}}}
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|US|1000000|1990|r{{=}}2}}<nowiki>}}</nowiki></code> = ${{formatnum:{{Inflation|US|1000000|1990|r=2}}}}
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|AU|1000000|1957|1978}}<nowiki>}}</nowiki>'''.00'''</code> = ${{formatnum:{{Inflation|AU|1000000|1957|1978}}}}.00
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|CA|1000000|1916|1978|r{{=}}-4}}<nowiki>}}</nowiki></code> = ${{formatnum:{{Inflation|CA|1000000|1916|1978|r=-4}}}}
* <code>'''€'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|FR|1000000|1957|1978}}<nowiki>}}</nowiki>'''.00'''</code> = €{{formatnum:{{Inflation|FR|1000000|1957|1978}}}}.00
* <code>'''¥'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|JP|1000000|1990|r{{=}}2}}<nowiki>}}</nowiki></code> = ¥{{formatnum:{{Inflation|JP|1000000|1990|r=2}}}}

===Très grands résultats===
Les résultats très importants sont exprimés en notation scientifique ("1.2E+14" au lieu de "120000000000000") ce qui n'est normalement pas souhaitable. Une solution de contournement consiste à exprimer la valeur à gonfler avec moins de chiffres, en ajoutant un texte multiplicateur tel que "billion" après le résultat, en utilisant le bouton "Afficher l'aperçu" autant de fois que nécessaire, en modifiant les paramètres jusqu'à ce que le meilleur résultat soit trouvé :

* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|US|1000000000|1900|r{{=}}-8}}<nowiki>}}</nowiki></code> = ${{formatnum:{{Inflation|US|1000000000|1900|r=-8}}}}
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|US|1000000|1900|r{{=}}-5}}<nowiki>}}</nowiki> ''mille''</code> = ${{formatnum:{{Inflation|US|1000000|1900|r=-5}}}} mille
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|US|1000|1900|r{{=}}-2}}<nowiki>}}</nowiki> ''million''</code> = ${{formatnum:{{Inflation|US|1000|1900|r=-2}}}} million
* <code>'''$'''<nowiki>{{formatnum:</nowiki>{{tlx|Inflation|US|1|1900|r{{=}}1}}<nowiki>}}</nowiki> ''milliard''</code> = ${{formatnum:{{Inflation|US|1|1900|r=1}}}} milliard

La section suivante fournit un moyen automatisé d'éviter ce scénario d'essai et d'erreur.

== Informer le lecteur ==
Afin de donner aux lecteurs le moyen de vérifier l'exactitude des données affichées, il est conseillé de fournir une référence pour les prix calculés avec ce modèle dans les articles où il est utilisé. C'est le rôle du modèle {{tlx|Inflation-info|code_pays}}. Il accepte un seul paramètre, le '''code_pays''' et s'intègre automatiquement dans les références à l'aide de {{tlx|Références}} ou <code><nowiki><references /></nowiki></code>.

Voici un exemple correct d'utilisation:
* <code><nowiki>En 1910 une ''barre chocolatée'' coûte environ £1. Aujourd’hui, elle coûte £{{formatnum:{{Inflation|</nowiki>'''UK'''<nowiki>|1|1910|r=2}}}}{{Inflation-info|</nowiki>'''UK'''<nowiki>}}</nowiki></code>

Le résultat de cet exemple (remarquez la référence à la fin de la phrase):
* En 1910 une ''barre chocolatée'' coûte environ £1. Aujourd’hui, elle coûte £{{formatnum:{{Inflation|UK|1|1910|r=2}}}}{{Inflation-info|UK}}

== Limitations ==
#Actuellement, il n'est pas possible de "dégonfler" une valeur à ce qu'elle aurait été l'année précédente. Si vous avez besoin de cette fonctionnalité, veuillez en faire la demande sur la  [[Discussion modèle:Inflation|page de discussion]] et/ou [[:en:Template talk:Inflation|en:talk page]]. L'ajouter ne sera pas difficile, mais cela ne sert à rien de le faire avant que quelqu'un en ait réellement besoin.
#La [[Aide:Modèle#Substitution|substitution]] n'est pas prise en charge du tout. Essayer de <code><nowiki>{{subst:</nowiki>[[Modèle:Inflation|Inflation]]<nowiki>|...}}</nowiki></code> n'entraînerait qu'une longue séquence de code d'analyseur intégré sans aucun avantage direct. Si vous n'avez besoin d'obtenir un prix gonflé qu'une seule fois, veuillez utiliser la page spéciale [[Spécial:ExpansionDesModèles|Expansion des modèles]] puis copiez le résultat et collez-le à l'emplacement souhaité.

== Documentation pour les développeurs ==
Ce modèle utilise une série de sous-modèles sans lesquels il ne peut fonctionner:
* Modèle:Inflation/CODE_PAYS (où CODE_PAYS est remplacé par UK, DE, etc)
* Modèle:Inflation/CODE_PAYS/table_de_données (contient la liste des indices des prix à la consommation (IPC) en fonction des années)
* Modèle:Inflation/CODE_PAYS/année_début (contient l'année minimale de l'inflation)

== Voir aussi ==
* {{m|Inflation-info}}
* {{m|Monnaie}}

== Notes et références ==
{{Références}}
<includeonly>
[[Catégorie:Modèle économie]]
</includeonly>
<templatedata>
{
	"params": {
		"1": {
			"label": "code_pays",
			"required": true
		},
		"2": {
			"label": "montant",
			"required": true
		},
		"3": {
			"label": "année_début",
			"required": true
		},
		"4": {
			"label": "année_fin"
		},
		"fmt": {},
		"r": {},
		"cursign": {}
	},
	"paramOrder": [
		"1",
		"2",
		"3",
		"4",
		"fmt",
		"r",
		"cursign"
	],
	"description": "Ce modèle prend un code pays ISO 3166-1 alpha-2, par exemple, \"US\" pour les États-Unis ou \"UK\" pour le Royaume-Uni, une valeur dans la monnaie du pays, une année de début, et applique à cette valeur l'Indice des prix à la consommation jusqu'à l'année en cours ou une autre année de fin."
}
</templatedata>

Modèles utilisés par cette page :

Modèle:En (voir la source) (protégé)
Modèle:Indication de langue (voir la source) (protégé)
Modèle:Inflation (modifier)
Modèle:Inflation-info (modifier)
Modèle:Inflation/AU (modifier)
Modèle:Inflation/AU/année début (modifier)
Modèle:Inflation/AU/table de données (modifier)
Modèle:Inflation/CA (modifier)
Modèle:Inflation/CA/année début (modifier)
Modèle:Inflation/CA/table de données (modifier)
Modèle:Inflation/DE (modifier)
Modèle:Inflation/DE/année début (modifier)
Modèle:Inflation/FR (modifier)
Modèle:Inflation/FR/année début (modifier)
Modèle:Inflation/FR/table de données (modifier)
Modèle:Inflation/JP (modifier)
Modèle:Inflation/JP/année début (modifier)
Modèle:Inflation/JP/table de données (modifier)
Modèle:Inflation/UK (modifier)
Modèle:Inflation/UK/année début (modifier)
Modèle:Inflation/UK/table de données (modifier)
Modèle:Inflation/US (modifier)
Modèle:Inflation/US/année début (modifier)
Modèle:Inflation/US/table de données (modifier)
Modèle:Lien vers modèle avec paramètres (modifier)
Modèle:Lien web (voir la source) (protégé)
Modèle:M (voir la source) (protégé)
Modèle:Méta documentation de modèle/styles.css (voir la source) (semi-protection étendue)
Modèle:Notice (voir la source) (protégé)
Modèle:Références (voir la source) (protégé)
Modèle:Sommaire à droite (modifier)
Modèle:Sous-page de documentation (voir la source) (semi-protégé)
Modèle:Tlx (modifier)
Module:Bandeau (voir la source) (protégé)
Module:Bandeau/Class (voir la source) (protégé)
Module:Biblio (voir la source) (protégé)
Module:Biblio/Commun (voir la source) (protégé)
Module:Biblio/Lien web (voir la source) (protégé)
Module:Biblio/Références (voir la source) (protégé)
Module:Correction syntaxique (voir la source) (semi-protection étendue)
Module:Date (voir la source) (protégé)
Module:Date/Data (voir la source) (semi-protection étendue)
Module:Langue (voir la source) (protégé)
Module:Langue/Data (voir la source) (semi-protection étendue)
Module:Outils (voir la source) (protégé)
Module:Yesno (voir la source) (protégé)

Revenir à la page Modèle:Inflation/Documentation.

Ce document provient de « https://fr.wikipedia.org/wiki/Modèle:Inflation/Documentation ».