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[1]. 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 end_year, 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.
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 r)
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 r pour déterminer la façon dont l'arrondi doit se faire. Pour obtenir les décimales, vous devez attribuer au paramètre r 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 FRF en 1960, entrer {{Inflation|FR|1000|1960|r=2}} donnerait un résultat (
12193.62) 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 € = FR 6,56 :
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 modèle spécial{{formatnum:}}.
{{formatnum:}} 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 "1 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.
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é :
${{formatnum:{{Inflation|US|1000000|1900|r=-5}}}} mille = $30 700 000 mille
${{formatnum:{{Inflation|US|1000|1900|r=-2}}}} million = $30 700 million
${{formatnum:{{Inflation|US|1|1900|r=1}}}} milliard = $30,7 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 {{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 {{Références}} ou <references />.
Voici un exemple correct d'utilisation:
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}}
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 £102,83[9]
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 page de discussion et/ou 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 substitution n'est pas prise en charge du tout. Essayer de {{subst:Inflation|...}} 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 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)
↑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 2024, d'autres jusqu'à environ juin-juillet 2024, et d'autres encore jusqu'au 31 décembre 2023.
↑Chiffres de l'inflation en Australie basés sur la Long Term Linked Series fournie par le Bureau australien des statistiques6461.0 – Consumer Price Index: Concepts, Sources and Methods, 2011 comme expliqué au §§3.10–3.11 (HISTORICAL BACKGROUND); les séries comprises "de 1901 à 1914, les séries A; de 1914 à 1946–47, les séries C; de 1946-47 à 1948-49, une combinaison des séries C, excluant les logements; et à partir de 1948–49, le CPI". Dernière modification le 19/12/2011. Dernière visite le 05/10/2013
↑Chiffres de l'inflation au Canada basés sur Statistics Canada. "Consumer Price Index, historical summary". CANSIM, table (gratuite) 326-0021 et Catalogues numéros. 62-001-X, 62-010-X and 62-557-X. Dernière modification le 25/01/2013. Dernière visite le 04/10/2013
↑Chiffres de l'inflation aux États-Unis basé sur les données de la Federal Reserve Bank of MinneapolisConsumer Price Index (Estimate) 1800-. Dernière visite le 16 mai 2020.
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.