Modèle:Inflation

Une page de Wikipédia, l'encyclopédie libre.

 Documentation[voir] [modifier] [historique] [purger]

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.

Utilisation[modifier le code]

{{Inflation|code_pays|montant|année_début}}
{{Inflation|code_pays|montant|année_début|année_fin}}
{{Inflation|code_pays|montant|année_début|année_fin|r=digit}}
{{Inflation|code_pays|montant|année_début|r=digit|fmt=c}}
{{Inflation|code_pays|montant|année_début|r=digit|fmt=eq}}
{{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:

Nom du pays code_pays année_début minimale dernière mise à jour
Australie[2] AU 1901 2010
Allemagne[3] DE 1882 2009
Belgique[4] BE 1399 2020
Canada[5] CA 1916 2018
États-Unis[6] US 1800 2019
France[7] FR 1901 2019
Japon[8] JP 1946 2013
Royaume-Uni[9] UK 1264 2019
Suisse[10] CH 1501 2021

Paramètres[modifier le code]

  • 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)[modifier le 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 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[modifier le code]

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 :

  • {{#expr:({{Inflation|FR|1000|1960|r=2}} / 6.56) round 2}} = 1858.78

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[modifier le code]

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.

  • DM {{formatnum:{{Inflation|DE|1000000|1957|1978}}}}.00 = DM 2 006 102.00
  • £{{formatnum:{{Inflation|UK|1000000|1323|1978|r=-4}}}} = £114 610 000
  • ${{formatnum:{{Inflation|US|1000000|1990|r=2}}}} = $1 956 953,64
  • ${{formatnum:{{Inflation|AU|1000000|1957|1978}}}}.00 = $3 065 502.00
  • ${{formatnum:{{Inflation|CA|1000000|1916|1978|r=-4}}}} = $5 460 000
  • {{formatnum:{{Inflation|FR|1000000|1957|1978}}}}.00 = €3 828 375.00
  • ¥{{formatnum:{{Inflation|JP|1000000|1990|r=2}}}} = ¥1 058 201,06

Très grands résultats[modifier le code]

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|1000000000|1900|r=-8}}}} = $30 700 000 000
  • ${{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[modifier le code]

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[modifier le code]

  1. 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.
  2. 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[modifier le code]

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[modifier le code]

Notes et références[modifier le code]

  1. 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 2023, d'autres jusqu'à environ juin-juillet 2023, et d'autres encore jusqu'au 31 décembre 2022.
  2. Chiffres de l'inflation en Australie basés sur la Long Term Linked Series fournie par le Bureau australien des statistiques 6461.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
  3. Chiffres de l'inflation en Allemagne basés sur Deutsches Statistisches Bundesamt.
  4. Chiffres de l'inflation en Belgique d'après Prices and Wages in Antwerp & Belgium, 1366-1913 (1399-1849) et [1] (1850-2020). Dernière mise à jour à l'indice de 2020.
  5. 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
  6. Chiffres de l'inflation aux États-Unis basé sur les données de la Federal Reserve Bank of Minneapolis Consumer Price Index (Estimate) 1800-. Dernière visite le 16 mai 2020.
  7. Chiffres de l'inflation en France d'après l'INSEE. Coefficient de transformation de l'euro ou du franc d'une année, en euro ou en franc d'une autre année – Base 1998 et Base 2015. Dernière mise à jour à l'indice de 2023.
  8. Indices des prix à la consommation disponible auprès du Bureau des statistiques du Japon. Japan Historical Consumer Price Index (CPI) - 1970 to 2014. Consulté le 30 juillet 2014. De 1946 à 1970, informations puisées dans (ja) « 昭和戦後史 » (consulté le )
  9. a et b Chiffres de l'inflation au Royaume-Uni basés sur les données disponibles de Gregory Clark (2020), "What Were the British Earnings and Prices Then? (New Series)" sur le site MeasuringWorth.
  10. 1501 à 1813 : Roman Studer, Pascal Schuppli, (en) Deflating Swiss Prices over the Past Five Centuries, Historical Methods, 2008, Volume 41, Numéro 3. 1813 à aujourd'hui : inflation de la Suisse basée sur FSO-EN à 2015, FSO-DE 2015-2021 « CPI, Global index on all index bases », Federal Statistical Office (consulté le ) et tableau 18-10-0004-13 « LIK, Totalindex auf allen Indexbasen », sur Federal Statistical Office (consulté le )

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.

Paramètres du modèle[Modifier les données du modèle]

ParamètreDescriptionTypeÉtat
code_pays1

aucune description

Inconnuobligatoire
montant2

aucune description

Inconnuobligatoire
année_début3

aucune description

Inconnuobligatoire
année_fin4

aucune description

Inconnufacultatif
fmtfmt

aucune description

Inconnufacultatif
rr

aucune description

Inconnufacultatif
cursigncursign

aucune description

Inconnufacultatif