模板:Inflation

File:Test Template Info-Icon - Version (2).svg 模板文件[檢視] [編輯] [歷史] [清除快取]

模板有三個必填參數，包括country_code、value及start_year。通脹率資料可在模板的子頁面找到及編輯，如美國通脹率資料存在Template:Inflation/US/dataset，每年有新的資料，所有引用此模板的頁面便會自動更新。

另外，編者可使用end_year參數，指定某年之間的通脹率。

用法

{{Inflation|國家代碼|value|start_year}}
{{Inflation|國家代碼|value|start_year|end_year}}
{{Inflation|國家代碼|value|start_year|r=decimals|fmt=c}}
{{Inflation|國家代碼|value|start_year|r=decimals|fmt=eq}}
{{Inflation|國家代碼|value|start_year|r=decimals|fmt=eq|cursign=X}}

此模板支援以下的貨幣：

國家代碼	國家	最早支援年份start_year	最晚支援年份end_year
AU	澳洲	1901	2018
AU-road	澳洲[...?]	1998	2018
CA	加拿大	1688	2020
DE	德國	1882	2021
JP	日本	1868	2019
UK	英國	1209	2023
US	美國	1800	2025
US-GDP	美國平均物價指數	1790	2020

• end_year：如有輸入，數值必須比start_year大，比現時年份小。沒有輸入則預設為今年。
• r=digit：設定四捨五入至某個數值，預設為0。

例子：

• Green tickY {{Inflation|DE|1000000|2000}} = 661641
• Green tickY {{Inflation|US|1000000|2001|2001}} = 相當於2001年的$1,000,000
• Green tickY {{Inflation|US|1000000|1990|2005|r=2}} = 1494905.76
• Green tickY {{Inflation|UK|1000000|1323|1978|r=-3}} = 114610000

• Green tickY {{Inflation|JP|100|2000}} → 102
• Green tickY {{Inflation|DE|100|2000}} → 66
• Green tickY {{Inflation|US|595|1982}} → 1985
• Green tickY {{Inflation|US|595|1982|fmt=eq}} → 相當於2025年的$1,985
• Green tickY {{Inflation|US|800|1942|fmt=eq|r=-3}} → 相當於2025年的$16,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（相當於2025年的$1,985）
• Green tickY US$595（{{Inflation|US|595|1982|fmt=eq|cursign=[[美元|US$]]}}） → US$595（相當於2025年的US$1,985）
• Green tickY $2,100萬（相当于{{Inflation/year|US}}的${{Inflation|US|2100|2005|r=0}}萬） → $2,100萬（相當於2025年的$3462萬）
• Green tickY {{Inflation|UK|1|1209|fmt=eq|cursign=£}} → 相當於2023年的£1,780
• Green tickY {{Inflation|AU|100|2026|fmt=eq}} → 相當於2026年的$100
• Green tickY {{Inflation/year|US}}年的${{Inflation|US|100|2026}} → 2025年的$100
• Green tickY {{Inflation|UK|100|1982|fmt=eq|orig=yes|cursign=£}} → 相當於2023年的£446

參數不當會顯示NaN：

• Red XN {{Inflation}} =
• Red XN {{Inflation|abc}} =
• Red XN {{Inflation|DE|1000000}} =
• Red XN {{Inflation|US|1000000|1200|3000}} =
• Red XN {{Inflation|UK|1000000|2005|2004}} =

提示與技巧

貨幣轉換

此模板不能轉換貨幣單位，因此，如果想知道1960時的1000德國馬克於現在的價值，輸入{{Inflation|DE|1000|1960|r=2}}顯示的數值仍爲德國馬克，而非歐元。

所以，如要轉換貨幣單位，需要手動輸入數式，下面例子定義€ 1 = DM 1.95583：

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

四捨五入

|r=參數可以定義要四捨五入的數位，輸入|r=2會約至2個小數點；輸入|r=-3會約至千位；輸入|r=-6會約至百萬位，如此類推。

Formatnum

為達到更佳效果，編者可以使用{{formatnum:}}，用{{Formatprice}}也可。這個功能為數值每三個數位加上一個分隔逗號，但編者不能控制顯示多少小數位。

• Green tickY DM {{formatnum:{{Inflation|DE|1000000|1957|1978}}}}.00 = DM 2,006,102.00
• Green tickY £{{formatnum:{{Inflation|UK|1000000|1323|1978|r=-4}}}} = £114,610,000
• Green tickY ${{formatnum:{{Inflation|US|1000000|1990|r=2}}}} = $2,464,340.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:

• Red XN ${{formatnum:{{Inflation|US|1000000000|1900|r=-8}}}} = $38,700,000,000
• Red XN ${{formatnum:{{Inflation|US|1000000|1900|r=-5}}}} thousand = $38,700,000 thousand
• Green tickY ${{formatnum:{{Inflation|US|1000|1900|r=-2}}}} million = $38,700 million
• Green tickY ${{formatnum:{{Inflation|US|1|1900|r=1}}}} billion = $38.7 billion

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

Formatprice

{{Formatprice}} is a template specifically designed to display price values, both big and small, in a more pleasant way than {{formatnum:}} allows for. For example, instead of showing the whole of a huge number such as "953,783,409,856.12", it would show it as "9538億", while small numbers have their cents part appearing as expected, "1234.5" being properly shown as "1.23千".

On the down side, {{Formatprice}} has no built-in intelligent handling of user locale settings, which means that some users might see a dot or a comma the opposite way they'd expect. As a general rule of thumb this shouldn't be a serious concern though, as most numbers in Wikipedia are hand-written anyway and will show as entered regardless of user settings.

• Green tickY DM {{Formatprice|{{Inflation|DE|1000000|1957|1978}}}} = DM 201萬
• Green tickY £{{Formatprice|{{Inflation|UK|1000000|1323|1978|r=-4}}}} = £1.15億
• Green tickY ${{Formatprice|{{Inflation|US|1000000|1990|r=2}}}} = $246萬
• Green tickY ${{Formatprice|{{Inflation|US|1000000000|1900|r=-8}}}} = $387億

Documenting

It's a good practice to provide a valid reference for the prices calculated with this template in the articles where it's used. The template {{Inflation/fn|country}} was developed to ease this task. It accepts as its single parameter the same country codes used here, and will generate one or more appropriate footnotes. Typically, this is how a piece of text using it looks like:

• In 1910 a ''blah'' cost on average £1,000. This is equivalent to £{{Formatprice|{{Inflation|UK|1000|1910|r=2}}}} in present day terms.{{Inflation/fn|UK}}

Resulting in this converted code (notice the footnote link at the end):

• In 1910 a blah cost on average £1,000. This is equivalent to £12.9萬 in present day terms.

The footnote thus generated appears whenever {{reflist}} or <references /> is used in an article, usually in its "References" section. See below for the live example in this document's own References section, or click the above generated footnote to jump to it.

Limitations

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.

Developer Documentation

An inflation series represents templates in the following categories:

• Template:Inflation/name
• Template:Inflation/name/dataset
• Template:Inflation/name/startyear
• Template:Inflation/doc/name (Which is then displayed at Inflation/name/dataset as the documentation, and needs to refer to the original data source)

Modifications need to be made to:

• Template:Inflation/fn

重定向

• {{通脹}}

參見

• {{Inflation/year}}
• {{Inflation/fn}}
• {{Format price}}
• Tabular data of consumer price indices
• Category:貨幣模板
• 通貨膨脹
• 消費者物價指數
• 流通貨幣列表
• 平均物價指數
• Category:使用Inflation模板時錯誤的頁面（0）

參考資料

上述文件嵌入自Template:Inflation/doc。（編輯 | 歷史）
編者可以在本模板的沙盒（編輯 | 差異）和測試樣例（編輯）頁面進行實驗。
請在/doc子頁面中添加分類。本模板的子頁面。