Template:Inflation/doc
これはTemplate:Inflationの解説サブページです。 使用方法、カテゴリ、およびその他テンプレートページ自体に含まれない情報を収容しています。 |
このテンプレートは消費者物価指数、商品、労務費、賃貸費、小額サービス(医療費、鉄道運賃)のインフレ率のみに使用することが出来ます。このテンプレートは国家予算や、政府支出、個人所得などには使うことが出来ません。誤った使用方法は独自研究とみなされます。もし、使い方がわからないのであれば経済学の知識をもっている人に相談してよく理解してから使ってください。 |
このテンプレートを使用して計算された数値が「現在」のものであることを前提にしないで下さい。「2024年時点」や「2023年時点」あるいは「最近」とすることも含みます。{{CURRENTYEAR}} を使うのではなく、end_year で特定、あるいは|fmt=eq または{{Inflation/year}} を使うことを推奨します。w:MOS:REALTIMEも参照。 |
このテンプレートの記述は複雑な構成となっています。編集後の結果が予想できないか、または変更にともなう影響を修正する用意ができていない場合は編集をお控えください。練習や実験はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページでお願いします。 |
このテンプレートでは、国名の略称、たとえばアメリカ合衆国であれば"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 | 1688 |
ドイツ[4] | DE | 1882 |
日本[5] | JP | 1946 |
イギリス[6] | UK | 1209 |
アメリカ[7] | US | 1800 |
南アフリカ[8] | ZAR | 1960 |
パラメータの説明
[編集]- 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で通貨記号を与えます。デフォルトは$です。
例
[編集]-
{{Inflation|DE|100|2000}}
→ 117 -
{{Inflation|US|595|1982}}
→ 1879 -
{{Inflation|US|595|1982|fmt=eq}}
→ 2023年時点の$1,879と同等 -
{{Inflation|US|800|1942|fmt=eq|r=-3}}
→ 2023年時点の$15,000と同等 -
{{Inflation|US|100|2010|2012|fmt=eq|r=2}}
→ 2012年時点の$105.28と同等 -
US $595 ({{Inflation|US|595|1982|fmt=eq}})
→ US $595 (2023年時点の$1,879と同等) -
US $595 ({{Inflation|US|595|1982|fmt=eq|cursign=[[United States dollar|US$]]}})
→ US $595 (2023年時点のUS$1,879と同等) -
$21 million (equivalent to ${{Inflation|US|21|2005|r=2}} million in {{Inflation/year|US}})
→ $21 million (equivalent to $32.76 million in 2023) -
{{Inflation|UK|1|1323|fmt=eq}}
→ 2023年時点の$831と同等 -
{{Inflation|UK|1|1323|fmt=eq|cursign=£}}
→ 2023年時点の£831と同等 -
{{Inflation|AU|100|2024|fmt=eq}}
→ 2024年時点の$100と同等
エラーメッセージを出さずに不正な方法でテンプレートを使うことができます。テンプレート説明の最初にある警告と適切な使用をお読み下さい。
-
$100 (${{Inflation|US|595|1982|fmt=c}} today)
→ $595 ($1,879 today) -
$100 (${{Inflation|US|595|1982|fmt=c}} in {{CURRENTYEAR}})
→ $100 ($1,879 in 2024) -
$100 (${{Inflation|US|595|1982|fmt=c}} adjusted for inflation)
→ $100 ($1,879 adjusted for inflation) -
$100 ({{Inflation|US|595|1982|fmt=eq}})
→ $100 (2023年時点の$1,879と同等) -
$100 (equivalent to ${{Inflation|US|595|1982|fmt=c}} in {{Inflation/year|US}})
→ $100 (equivalent to $1,879 in 2023) -
山田は1975年に1億米ドルを稼いだ。{{Inflation/year|US}}年時点で{{Inflation|US|1|1975|fmt=c}}億米ドルの資産を有することとなる。
→ 山田は1975年に1億米ドルを稼いだ。2023年時点で6億米ドルの資産を有することとなる。 -
山田は1975年に1億米ドルを稼いだ。これは{{Inflation/year|US}}年時点の{{Inflation|US|1|1975|fmt=c}}億米ドルと同等である。
→ 山田は1975年に1億米ドルを稼いだ。これは2023年時点の6億米ドルと同等である。
無効なパラメータが入力されたり必要なパラメータが入力されていないと、出力ページにエラーメッセージを出してCategory:テンプレートを正しく使用していないページにカテゴライズします。
-
{{Inflation}}
→ テンプレート使用エラー {{Inflation}}:|index=
(パラメータ1),|value=
(パラメータ2) および|start_year=
(パラメータ3)が指定されていません。 -
{{Inflation|abc}}
→ テンプレート使用エラー {{Inflation}}:|value=
(パラメータ2) および|start_year=
(パラメータ3)が指定されていません。 -
{{Inflation|AU}}
→ テンプレート使用エラー {{Inflation}}:|value=
(パラメータ2) および|start_year=
(パラメータ3)が指定されていません。 -
{{Inflation|AU|100}}
→ テンプレート使用エラー {{Inflation}}:|start_year=
(パラメータ3)が指定されていません。 -
{{Inflation|abc|€100|1980}}
→ テンプレート使用エラー {{Inflation}}:|index=abc
(パラメータ1)はインデックスとして正しくありません。 -
{{Inflation|DE|€100|1980}}
→ テンプレート使用エラー {{Inflation}}: NaN, パラメータが数値であることを確認して下さい:|value=€100
(パラメータ2),|end_year={{{4}}}
(パラメータ4) および|r={{{r}}}
. -
{{Inflation|DE|€100|zzzz|zzzz|r=zzzz}}
→ テンプレート使用エラー {{Inflation}}: NaN, パラメータが数値であることを確認して下さい:|value=€100
(パラメータ2),|start_year=zzzz
(パラメータ3),|end_year=zzzz
(パラメータ4) および|r=zzzz
. -
{{Inflation|AU|100|1200|2025}}
→ テンプレート使用エラー {{Inflation}}:|start_year=1200
(パラメータ3) はインデックス "AU"の 指定可能な最初の年 (1901)より小さい値です。 また|end_year=2025
(パラメータ4)がインデックス "AU"の最も直近の年 (2018)より大きな値です。. -
{{Inflation|AU|100|2005|2004}}
→ テンプレート使用エラー {{Inflation}}:|start_year=2005
(パラメータ3) が|end_year=2004
(パラメータ4)より大きな値です。. -
{{Inflation|AU|100|2005|2025|fmt=eq}}
→ テンプレート使用エラー {{Inflation}}:|end_year=2025
(パラメータ4)がインデックス "AU"の最も直近の年 (2018)より大きな値です。. -
{{Inflation|AU|100|2024|2025|fmt=eq}}
→ テンプレート使用エラー {{Inflation}}:|end_year=2025
(パラメータ4)がインデックス "AU"の最も直近の年 (2018)より大きな値です。. -
{{Inflation|AU|100|2024|1905|fmt=eq}}
→ テンプレート使用エラー {{Inflation}}:|start_year=2024
(パラメータ3) が|end_year=1905
(パラメータ4)より大きな値です。. -
{{Inflation|AU|100|2025|fmt=eq}}
→ テンプレート使用エラー {{Inflation}}:|start_year=2025
(パラメータ3) が インデックス "AU"の最も直近の年 (2018)より大きな値です。.
ヒント
[編集]通貨変換
[編集]このテンプレートは通貨間の変換をすることが出来ません。たとえば、1960年の1,000.00ドイツマルクが現在の価値でいくらになるか{{Inflation|DE|1000|1960|r=2}}
と入力して計算しようとしても、値はドイツマルク(4046.74)で返されます。ユーロには変換されません。
複数の通貨間で変換が必要な場合は手動で計算しなければなりません。たとえば、ユーロとドイツマルクの間の換算レートは€ 1 = DM 1.95583です。
-
{{#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"などの様に指数で返されますが、百科事典の記事としてはあまり好ましい形ではありません。これを防ぐために、何回かプレビューをしながらパラメータを調整することが推奨されます。
-
${{Inflation|US|1000000000000|1900|r=-11|fmt=c}}
→ $36,600,000,000,000 -
${{Inflation|US|10000000000000|1900|r=-12|fmt=c}}
→ $366,000,000,000,000 -
${{Inflation|US|1000000000|1900|r=-8|fmt=c}}万
→ $36,600,000,000万 -
${{Inflation|US|10000000|1900|r=-6|fmt=c}}百万
→ $366,000,000百万 -
${{Inflation|US|10000|1900|r=-3|fmt=c}}億
→ $366,000億 -
${{Inflation|US|1|1900|r=1|fmt=c}}兆
→ $36.6兆
試行錯誤を防ぐため、次節の様なやり方もあります。
Format priceテンプレートの利用
[編集]{{Format price}}
は価格を表すために作られたテンプレートです。たとえば、"953,783,409,856.12"などの代わりに"9538億"と表示されます。"1234.5"は "1,234.50"となります。
-
${{Format price|{{Inflation|US|10000000000000|1900}}}}
→ $366兆 -
${{Format price|{{Inflation|US|1000000|1990}}}}
→ $233万 -
DM {{Format price|{{Inflation|DE|1000000|1957|1978}}}}
→ DM 201万 -
£{{Format price|{{Inflation|UK|1000|1323}}}}
→ £83.1万
出典の表示
[編集]このテンプレートを使うとき、{{Inflation/fn}}を用いてインフレ率の出典を示すことが推奨されます。国コードを設定すると、1つまたは2つの脚注が生成されます。次のように使用します。
1985年には平均単価は$1,040だった。これは{{Inflation|US|1040|1985|fmt{{=}}eq}}}}である{{Inflation/fn|US}}。
以下の様に表示されます。
- 1985年には平均単価は$1,040だった。これは2023年時点の$2,946と同等である[7]。
脚注はその記事で一番近い{{reflist}}
または<references />
に表示されます。この記事の場合は以下のReferencesを参照するか、上記の脚注番号をクリックしてください。
限界
[編集]- 現状では逆算、つまり現在の通貨価値を過去の通貨価値に換算することはできません。
- Substitutionには対応していません。
開発者のために
[編集]インフレ率のテンプレートは以下の名前で作成してください。
- Template:Inflation/name
- Template:Inflation/name/dataset
- Template:Inflation/name/startyear
- Template:Inflation/doc/name
数値を修正した場合は以下のものの修正を併せてお願いいたします。
サブページ一覧:
通貨単位・インフレ換算テンプレート:
関連項目
[編集]- {{Inflation/fn}}
- {{Format price}}
- インフレーション
- 消費者物価指数
脚注
[編集]- ^ どの程度近年までかは毎年1月に更新されるデータテーブルがどのように構成されているかによります。データテーブルによっては12月に更新されるものも 2023も年央に更新されるものも2023、年末に更新されるものもあります2022。
- ^ オーストラリアのインフレ率はオーストラリア政府統計局の2019年の集計6461.0 – Consumer Price Index: Concepts, Sources and Methods, 2019で§§3.10–3.11で説明されているものによる。この数値は、いくつかの統計値から産出されたものであることに注意を要する。
- ^ カナダのインフレ率のうち、1688年から1923年までの出典はGeloso, Vincent, A Price Index for Canada, 1688 to 1850 (December 6, 2016). 1924年以降の出典はStatistics Canadaのテーブル18-10-0005-01(元CANSIM 326-0021)"Consumer Price Index, annual average, not seasonally adjusted" (英語). Statistics Canada. 2024年6月9日閲覧。と18-10-0004-13 "Consumer Price Index by product group, monthly, percentage change, not seasonally adjusted, Canada, provinces, Whitehorse, Yellowknife and Iqaluit" (英語). Statistics Canada. 2024年6月9日閲覧。
- ^ ドイツのインフレ率は次による。Deutsches Statistisches Bundesamt.
- ^ 日本のインフレ率は総務省統計局集計による。2022年は“昭和40年の1万円を、今のお金に換算するとどの位になりますか?”. 日本銀行. 4 March 2023閲覧。、1955年から2021年までは“長期経済統計 物価”. 内閣府. 4 March 2023閲覧。、1946年から1954年までは“昭和戦後史”. 4 March 2023閲覧。による。
- ^ イギリスのインフレ率の出典はClark, Gregory (2024). "The Annual RPI and Average Earnings for Britain, 1209 to Present (New Series)". MeasuringWorth (英語). 2024年5月31日閲覧。
- ^ a b Federal Reserve Bank of Minneapolis Community Development Project. "Consumer Price Index (estimate) 1800–" (英語). Federal Reserve Bank of Minneapolis. 2019年1月2日閲覧。
- ^ インフレ率は自動的に計算されたものである。