Template:Inflation

出典: フリー百科事典『ウィキペディア(Wikipedia)』
移動先: 案内検索
テンプレートの解説[表示] [編集] [履歴] [キャッシュを破棄]

このテンプレートでは、国名の略称、たとえばアメリカ合衆国であれば"US"、イギリスであれば"UK"とstart_year(開始年)を入力すればその年から近年までの消費者物価指数のインフレ率を返します[1]。たとえば、アメリカであればインフレ率のデータはTemplate:Inflation/US/datasetという名前のサブテンプレートにあります。つまり、サブテンプレートのデータが毎年更新されていれば、このテンプレートを呼び出している記事のインフレ率は常に現在のものと、指定した年との間のものになります。

end_year(最終年)を指定することで、2つの年の間のインフレ率を計算することもできます。

使い方[編集]

{{Inflation|country_code|value|start_year}}
{{Inflation|country_code|value|start_year|end_year}}
{{Inflation|country_code|value|start_year|r=decimals|fmt=c}}
{{Inflation|country_code|value|start_year|r=decimals|fmt=eq}}
{{Inflation|country_code|value|start_year|r=decimals|fmt=eq|cursign=X}}

対応している国名と国コードstart_yearの最小値は下表のとおりです。

国名 コード start_year

最小値

オーストラリア[2] AU 1901
カナダ[3] CA 1916
ドイツ[4] DE 1882
日本[5] JP 1946
イギリス[6] UK 1264
アメリカ[7] US 1800

パラメータの説明[編集]

  • country_code (パラメータ1)は国コードで、AU, CA, DE, JP, UK, USなどです。
  • value (パラメータ2)は計算したい値です。桁区切りを入れることが出来ますが、通貨記号を入れることはできません。
  • start_year (パラメータ3) はインフレ率の計算の最初の年です。どの年をえらべるかは国により異なります。
  • end_year (パラメータ4), は任意です。数値が与えられている場合、インフレ率の計算の最後の年です。どの年をえらべるかは国により異なりますが、start_yearより大きな値で、今年より前である必要があります。ここに値を入れない場合は、デーてテーブルにある最新年のデータをもちいます。
  • r=小数'で、小数点以下何桁まで表示するかを与えます。何も値がないか、0が与えられた時は小数点以下は四捨五入されます。
  • fmt=c を与えると返される値に桁区切りが入ります。
  • fmt=eq を与えると、「と同等」の言葉が入ります。
  • cursign=X通貨記号を与えます。デフォルトは$です。

[編集]

  • Green tickY {{Inflation|DE|100|2000}}117
  • Green tickY {{Inflation|US|595|1982}}1459
  • Green tickY {{Inflation|US|595|1982|fmt=eq}}2015年時点の$1,459と同等
  • Green tickY {{Inflation|US|800|1942|fmt=eq|r=-3}}2015年時点の$12,000と同等
  • Green tickY {{Inflation|US|100|2010|2012|fmt=eq|r=2}}2012年時点の$105.28と同等
  • Green tickY US $595 ({{Inflation|US|595|1982|fmt=eq}})US $595 (2015年時点の$1,459と同等)
  • Green tickY US $595 ({{Inflation|US|595|1982|fmt=eq|cursign=[[United States dollar|US$]]}})US $595 (2015年時点のUS$1,459と同等)
  • Green tickY $21 million (equivalent to ${{Inflation|US|21|2005|r=2}} million in {{Inflation-year|US}})$21 million (equivalent to $25.44 million in 2015)
  • Red XN {{Inflation|UK|1|1323|fmt=eq}}2013年時点の$574と同等
  • Green tickY {{Inflation|UK|1|1323|fmt=eq|cursign=£}}2013年時点の£574と同等
  • Green tickY {{Inflation|AU|100|2016|fmt=eq}}2016年時点の$100と同等

エラーメッセージを出さずに不正な方法でテンプレートを使うことができます。テンプレート説明の最初にある警告と適切な使用をお読み下さい。

  • Red XN $100 (${{Inflation|US|595|1982|fmt=c}} today)$595 ($1,459 today)
  • Red XN $100 (${{Inflation|US|595|1982|fmt=c}} in {{CURRENTYEAR}})$100 ($1,459 in 2016)
  • Red XN $100 (${{Inflation|US|595|1982|fmt=c}} adjusted for inflation)$100 ($1,459 adjusted for inflation)
  • Green tickY $100 ({{Inflation|US|595|1982|fmt=eq}})$100 (2015年時点の$1,459と同等)
  • Green tickY $100 (equivalent to ${{Inflation|US|595|1982|fmt=c}} in {{Inflation-year|US}})$100 (equivalent to $1,459 in 2015)
  • Red XN Jane Doe amassed a fortune of $1 billion in 1975, making her worth ${{Inflation|US|1|1975|fmt=c}} billion in {{Inflation-year|US}}.Jane Doe amassed a fortune of $1 billion in 1975, making her worth $4 billion in 2015.
  • Green tickY Jane Doe amassed a fortune of $1 billion in 1975, equivalent to ${{Inflation|US|1|1975|fmt=c}} billion in {{Inflation-year|US}}.Jane Doe amassed a fortune of $1 billion in 1975, equivalent to $4 billion in 2015.

無効なパラメータが入力されたり必要なパラメータが入力されていないと、出力ページにエラーメッセージを出してCategory:テンプレートを正しく使用していないページにカテゴライズします。

  • Red XN {{Inflation}}テンプレート使用エラー {{Inflation}}: |index= (パラメータ1), |value= (パラメータ2) および |start_year= (パラメータ3)が指定されていません。
  • Red XN {{Inflation|abc}}テンプレート使用エラー {{Inflation}}: |value= (パラメータ2) および |start_year= (パラメータ3)が指定されていません。
  • Red XN {{Inflation|AU}}テンプレート使用エラー {{Inflation}}: |value= (パラメータ2) および |start_year= (パラメータ3)が指定されていません。
  • Red XN {{Inflation|AU|100}}テンプレート使用エラー {{Inflation}}: |start_year= (パラメータ3)が指定されていません。
  • Red XN {{Inflation|abc|€100|1980}}テンプレート使用エラー {{Inflation}}: |index=abc (パラメータ1)はインデックスとして正しくありません。
  • Red XN {{Inflation|DE|€100|1980}}テンプレート使用エラー {{Inflation}}: NaN, パラメータが数値であることを確認して下さい: |value=€100 (パラメータ2), |end_year={{{4}}} (パラメータ4) および |r={{{r}}}.
  • Red XN {{Inflation|DE|€100|zzzz|zzzz|r=zzzz}}テンプレート使用エラー {{Inflation}}: NaN, パラメータが数値であることを確認して下さい: |value=€100 (パラメータ2), |start_year=zzzz (パラメータ3), |end_year=zzzz (パラメータ4) および |r=zzzz.
  • Red XN {{Inflation|AU|100|1200|2017}}テンプレート使用エラー {{Inflation}}: |start_year=1200 (パラメータ3) はインデックス "AU"の 指定可能な最初の年 (1901)より小さい値です。 また |end_year=2017 (パラメータ4)がインデックス "AU"の最も直近の年 (2009)より大きな値です。.
  • Red XN {{Inflation|AU|100|2005|2004}}テンプレート使用エラー {{Inflation}}: |start_year=2005 (パラメータ3) が |end_year=2004 (パラメータ4)より大きな値です。.
  • Red XN {{Inflation|AU|100|2005|2017|fmt=eq}}テンプレート使用エラー {{Inflation}}: |end_year=2017 (パラメータ4)がインデックス "AU"の最も直近の年 (2009)より大きな値です。.
  • Red XN {{Inflation|AU|100|2016|2017|fmt=eq}}テンプレート使用エラー {{Inflation}}: |end_year=2017 (パラメータ4)がインデックス "AU"の最も直近の年 (2009)より大きな値です。.
  • Red XN {{Inflation|AU|100|2016|1905|fmt=eq}}テンプレート使用エラー {{Inflation}}: |start_year=2016 (パラメータ3) が |end_year=1905 (パラメータ4)より大きな値です。.
  • Red XN {{Inflation|AU|100|2017|fmt=eq}}テンプレート使用エラー {{Inflation}}: |start_year=2017 (パラメータ3) が インデックス "AU"の最も直近の年 (2009)より大きな値です。.

ヒント[編集]

通貨変換[編集]

このテンプレートは通貨間の変換をすることが出来ません。たとえば、1960年の1,000.00ドイツマルクが現在の価値でいくらになるか{{Inflation|DE|1000|1960|r=2}}と入力して計算しようとしても、値はドイツマルク(4046.74)で返されます。ユーロには変換されません。

複数の通貨間で変換が必要な場合は手動で計算しなければなりません。たとえば、ユーロとドイツマルクの間の換算レートは€ 1 = DM 1.95583です。

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

通貨間の自動変換テンプレートが準備されたときには、この問題は解決されます。

数値の丸め[編集]

不必要に細かい数値を表示しないよう、|r=を指定することで、指定した桁から下の値を四捨五入することが出来ます。小数点以下2桁が必要な場合は|r=2を使います。|r=-3と、負の値を入れることもできます。この場合は千の位に四捨五入され、|r=-6では百万の位に四捨五入されます。このテンプレートのデータベースには1%程度の誤差があるため、不必要に細かい数値を表示することは推奨されません。

大きな数値を扱うとき[編集]

返される数値が非常に大きいとき、たとえば、値は"120000000000000"ではなく、"1.2E+14"などの様に指数で返されますが、百科事典の記事としてはあまり好ましい形ではありません。これを防ぐために、何回かプレビューをしながらパラメータを調整することが推奨されます。

  • Green tickY ${{Inflation|US|1000000000000|1900|r=-11|fmt=c}}$28,400,000,000,000
  • Red XN ${{Inflation|US|10000000000000|1900|r=-12|fmt=c}}$2.84E+14
  • Red XN ${{Inflation|US|10000000000|1900|r=-9|fmt=c}} thousand$284,000,000,000 thousand
  • Green tickY ${{Inflation|US|10000000|1900|r=-6|fmt=c}} million$284,000,000 million
  • Green tickY ${{Inflation|US|10000|1900|r=-3|fmt=c}} billion$284,000 billion
  • Green tickY ${{Inflation|US|10|1900|fmt=c}} trillion$284 trillion

試行錯誤を防ぐため、次節の様なやり方もあります。

Format priceテンプレートの利用[編集]

{{Format price}}は価格を表すために作られたテンプレートです。たとえば、"953,783,409,856.12"などの代わりに"9538億"と表示されます。"1234.5"は "1,234.50"となります。

  • Green tickY ${{Format price|{{Inflation|US|10000000000000|1900}}}}$284兆
  • Green tickY ${{Format price|{{Inflation|US|1000000|1990}}}}$181万
  • Green tickY DM {{Format price|{{Inflation|DE|1000000|1957|1978}}}}DM 201万
  • Green tickY £{{Format price|{{Inflation|UK|1000|1323}}}}£57.4万

出典の表示[編集]

このテンプレートを使うとき、{{Inflation-fn}}を用いてインフレ率の出典を示すことが推奨されます。国コードを設定すると、1つまたは2つの脚注が生成されます。次のように使用します。

  • 1985年には平均単価は$1,040だった。これは{{Inflation|US|1040|1985|fmt{{=}}eq}}}}である{{Inflation-fn|US}}。

以下の様に表示されます。

  • 1985年には平均単価は$1,040だった。これは2015年時点の$2,288と同等である[7]

脚注はその記事で一番近い{{reflist}}または<references />に表示されます。この記事の場合は以下のReferencesを参照するか、上記の脚注番号をクリックしてください。

限界[編集]

  1. 現状では逆算、つまり現在の通貨価値を過去の通貨価値に換算することはできません。
  2. Substitutionには対応していません。

開発者のために[編集]

インフレ率のテンプレートは以下の名前で作成してください。

  • Template:Inflation/name
  • Template:Inflation/name/dataset
  • Template:Inflation/name/startyear
  • Template:Inflation/doc/name

数値を修正した場合は以下のものの修正を併せてお願いいたします。

サブページ一覧:

通貨単位・インフレ換算テンプレート:

関連項目[編集]


脚注[編集]

  1. ^ どの程度近年までかは毎年1月に更新されるデータテーブルがどのように構成されているかによります。データテーブルによっては12月に更新されるものも 2015も年央に更新されるものも2015、年末に更新されるものもあります2014。
  2. ^ オーストラリアのインフレ率はオーストラリア政府統計局の2009年の集計6461.0 – Consumer Price Index: Concepts, Sources and Methods, 2009で§§3.10–3.11で説明されているものによる。この数値は、いくつかの統計値から産出されたものであることに注意を要する。
  3. ^ カナダのインフレ率はStatistics Canada、"Consumer Price Index, historical summary"による。CANSIM(有料サイト)、table 326-0021及びカタログ番号62-001-X,、62-010-X及び62-557-Xも参照している。Consumer Price Index, by province (monthly) (Canada)からのデータは2013-12-20付、2014年1月8日付のものが最新。
  4. ^ ドイツのインフレ率は次による。Deutsches Statistisches Bundesamt.
  5. ^ 日本のインフレ率は総務省統計局集計による。1970年以降は、Japan Historical Consumer Price Index (CPI) - 1970 to 2014”. 2014年7月30日閲覧。から、1946年から1969年は昭和戦後史”. 2015年1月24日閲覧。による。
  6. ^ イギリスのインフレ率はグレゴリー・クラーク(2014)、 "What Were the British Earnings and Prices Then? (New Series)" MeasuringWorthによる。
  7. ^ a b Consumer Price Index (estimate) 1800–2014. Federal Reserve Bank of Minneapolis. February 27, 2014閲覧。