Modèle:Inflation

Une page de Wikipédia, l'encyclopédie libre.
Aller à : navigation, rechercher
Documentation Documentation[modifier] [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 Template: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 mis à jour.

Alternatively, you can provide a second, optional end_year parameter, and the value will be inflated for the period between the two years, providing a convenient way of getting values from different time periods adjusted around the same date.

Utilisation[modifier | modifier le code]

{{Inflation|code_pays|montant|année_début|r=digit}}
{{Inflation|code_pays|montant|année_début|année_fin|r=digit}}
{{Inflation|code_pays|montant|année_début|r=digit}}
{{Inflation|code_pays|montant|année_début|r=digit}}

Les pays supportés 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
Australie[2] AU 1901
Canada[3] CA 1916
Allemagne[4] DE 1882
Royaume-Uni[5] UK 1264
États-Unis[6] US 1800

Paramètres[modifier | modifier le code]

  • code_pays (paramètre 1) peut être: AU, CA, DE, UK, US, UKNGDPPC, etc.
  • valeur (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 Tips & Tricks ci-dessous pour les détails d'utilisation de ce paramètre).
  • fmt=c will insert commas into the inflated value.
  • fmt=eq will show an equivalent-to phrase.
  • cursign=X will set the currency sign when 'fmt=eq' is used (default: $).

Arrondi (paramètre r)[modifier | 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.

Currency conversion[modifier | modifier le code]

This template is currency agnostic, which means it doesn't convert between different currencies. Thus, if you wanted to know how much DM 1,000.00 marks in 1960 are worth nowadays, entering {{Inflation|DE|1000|1960|r=2}} would provide a result (4062.93) still in marks, not in euros.

Consequently, if you need a result in another currency than the one in which the original value is stated, for now you must do the conversion manually, as in the following example which uses the defined conversion rate of € 1 = DM 1.95583:

  • {{#expr:({{Inflation|DE|1000|1960|r=2}} / 1.95583) round 2}} = 2077.34

A currency conversion template to ease these conversion tasks is planned. This section will be updated accordingly once it's developed.

Formater la valeur retournée[modifier | 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 757 259,3

Another potential source of difficulties resides in the way certain calculated values are expressed. In many cases the result comes as a number in engineering units ("1.2E+9" instead of "1200000000"), and when that happens {{formatnum:}}'ing the result fails. A workaround then is to express the value to be inflated with fewer digits, adding a multiplier text such as "million" after the result, and then hitting the "Show preview" button as many times as needed, changing parameters until the best result is found:

  • ${{formatnum:{{Inflation|US|1000000000|1900|r=-8}}}} = $27 600 000 000
  • ${{formatnum:{{Inflation|US|1000000|1900|r=-5}}}} thousand = $27 600 000 thousand
  • ${{formatnum:{{Inflation|US|1000|1900|r=-2}}}} million = $27 600 million
  • ${{formatnum:{{Inflation|US|1|1900|r=1}}}} billion = $27,6 billion

The following section provides an automated way of avoiding this trial and error scenario.

Informer le lecteur[modifier | modifier le code]

Afin de donner aux lecteurs le moyen de vérifier l'exactitude des données affichées, il est conseiller 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 {{reflist}} or <references />.

Voici un exemple correct d'utilisation:

  • En 1910 une ''barre chocolatée'' coûte environ £1. Aujourd’hui, elle coûte £{{Formatprice|{{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 £86,43[5]

Limitations[modifier | modifier le code]

  1. Currently it isn't possible to "de-inflate" a value to what it would have been in a previous year. If you need this functionality, please request it at the talk page. Adding it won't be difficult, but there's no point in doing so before someone actually needs it.
  2. Substitution isn't supported at all. Trying to {{subst:Inflation|...}} would only result in a long sequence of embedded parser code without any direct benefit. If you need to obtain an inflated price only once, please use the special ExpandTemplates page then copy the result and paste it at the desired location.

Documentation pour les développeurs[modifier | 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 (ou 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 | modifier le code]

  • (tl)

References[modifier | modifier le code]

  1. How recently depends on how the data set for each country is constructed, and on the internal tables being updated accordingly every January. Some data tables provide inflation data up to December 31, 2013, others up to roughly June-July 2013, and others yet up to December 31, 2012.
  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 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
  4. Chiffres de l'inflation en Allemagne basés sur Deutsches Statistisches Bundesamt.
  5. a et b Chiffres de l'inflation au Royaume-Uni basés sur les données disponibles de Gregory Clark (2013), "What Were the British Earnings and Prices Then? (New Series)" sur le site internet MeasuringWorth.
  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–2013. Dernière visite le March 31, 2013.