模板:Currency

模板文件[檢視] [編輯] [歷史] [清除快取]

概要

Formats a currency value with the appropriate symbol which is linked to the article about the currency. If no currency is specified, the template will show the amount in United States dollars.

參數及使用方法

Using unnamed parameters:

{{currency|value|code|first=|linked=|fmt=|passthrough=}}

Using named parameters:

{{currency|amount=value|code=code|first=|linked=|passthrough=}}

where:

value is a number with or without comma separators; may be followed by an optional quantifier: 'thousand', 'million', 'M', 'billion', 'B', or 'trillion'

code is an ISO 4217 currency code or one of the supported non-standard codes listed below

|first= when set to any value produces a long-form currency name

|linked= when set to no disables wikilinks on the rendered currency symbol or long-form currency name

|fmt= specifies how value digit-groups are separated:

commas (default) separates value digit-groups with commas; this is the default, same as when |fmt= is empty or omitted

gaps separates value digit-groups with narrow gaps

none renders value without digit grouping

Note: Using both named and unnamed parameters may produce unexpected results. In this example, the template expects the first unnamed parameter to be a value number:

{{Currency|amount=1000|GBP}}

|passthrough= specifies whether or not the template should attempt to parse the number according to |fmt= or just put whatever string is provided in |amount= directly after the currency sign. Should have value of either |passthrough=yes or |passthrough=no

When using parameter names, |amount= and |code= are preferred. The template will also accept |Amount= and |type= and |Type=, though.

非標準貨幣代碼支持

可轉換為ISO 4217貨幣

These non-standard codes are aliases of standard ISO 4217 codes.

• EGE
• EU
• EURO
• FRW
• KSH
• NEP
• POUND
• POUND STERLING
• RMB
• TSH
• UK
• UNITED STATES
• US
• U.S.
• USA
• USH

其他非標準貨幣代碼

These codes either do not have a matching ISO 4217 currency code or are alternate versions of existing ISO 4217 codes or support unique aspects of a currency.

• BITCOIN – no matching ISO 4217 code
• BTC – no matching ISO 4217 code
• DKK2 – alternate version of DKK
• FRF – historical
• GRD – historical
• LSL2 – plural version of LSL
• LTL – historical
• NOK2 – alternate version of NOK
• SEK2 – alternate version of SEK
• SZL2 – plural version of SZL
• US$ - special case: like the standard codes "USD" (and "$"), but only displays "$" instead of the longer "US$" (for articles where displaying "US$" might appear inappropriately long, but the template should still link to "United States dollar" to avoid any ambiguity)
• XBT – no matching ISO 4217 code

範例

Currencies other than the United States dollar can be rendered by using the appropriate ISO 4217 currency code

• {{Currency|1000|BMD}} → BD$1,000（Bermudian dollar）
• {{Currency|1000|BDT}} → ৳1,000（Bangladeshi taka）
• {{Currency|1000|AMD}} → ֏ 1,000（Armenian dram）

Some of the more well known currencies also provide the ability to use common abbreviations or full names.

• {{Currency|1000|us}} → US$1,000
• {{Currency|1000|United States}} → US$1,000
• {{Currency|1,000|JPY}} → ¥1,000

Parameter names can also be used, if preferred:

• {{Currency|amount=1000|code=US}} → US$1,000
• {{Currency|1000|code=euro}} → €1,000

Negative amount:

• {{Currency|amount=-1000|code=US}} → US$−1,000

Text quantifiers:

• {{Currency|1000 million|code=euro}} → €1,000,000,000
• {{Currency|1000M|code=euro}} → €1,000,000,000

The first use of a currency should show the value and the full name of the currency, so if the "first" parameter is defined then that is what will be given.

• {{Currency|1000|cve|first=yes}} → 1,000維德角埃斯庫多
• {{Currency|1000|cve}} → 1.000$00

Because the symbol for the currencies DKK, NOK, and SEK may be ambiguous, these may be represented in two ways:

• For DKK:

  {{Currency|1000|dkk}} → kr. 1,000

  {{Currency|1000|dkk2}} → DKK 1,000

• For NOK:

  {{Currency|1000|NOK}} → kr 1,000

  {{Currency|1000|NOK2}} → NOK 1,000

• For SEK:

  {{Currency|1000|SEK}} → kr 1,000

  {{Currency|1000|SEK2}} → SEK 1,000

Similarly, some currencies use different symbols for single and plural amounts:

• {{Currency|1|LSL}} → L1

  {{Currency|1000|LSL2}} → M1,000

  The template does not currently make this distinction automatically so it is the responsibility of the editor using these kinds of codes to get the code right.

Digit grouping:

• |fmt=commas

  {{Currency|1000 million|code=euro|fmt=commas}} → €1,000,000,000

• |fmt=gaps

  {{Currency|1000 million|code=euro|fmt=gaps}} → €1000000000

• |fmt=none

  {{Currency|1000 million|code=euro|fmt=none}} → €1000000000

Passthrough:

• |passthrough=yes

  {{Currency|6 million|PHP|passthrough=yes}} → ₱6 million

  {{Currency|6 trillion|PHP|passthrough=yes}} → ₱6 trillion

  {{Currency|6 tn|PHP|passthrough=yes}} → ₱6 tn

• |passthrough=no

  {{Currency|6 million|PHP|passthrough=no}} → ₱6,000,000

  {{Currency|6 trillion|PHP|passthrough=no}} → ₱6,000,000,000,000

  {{Currency|6 tn|PHP|passthrough=no}} gives: (error expected, as template doesn't know how to parse 6 tn to 6,000,000,000,000)

• Use sparingly! Usually you want |fmt= instead. |passthrough= should only be used in ways compatible with MOS:CURRENCY.

錯誤訊息

{{currency}} can produce several error message. These are:

• – the value in the second unnamed parameter or assigned to |code= cannot be found in the template's list of codes. Make sure that the assigned code is a correct ISO 4217 currency code or one of the supported non-standard codes listed above.
• – the value in the first unnamed parameter or assigned to |amount= contains one or more characters that is not a minus sign, a digit, comma, or decimal point, or has some text that is not one of the permitted quantifiers. Make sure that comma separators group three digits and that the number has only one decimal point. Make sure that the amount and code parameters are either both named (|amount= and |code=) or both unnamed.
• – an internal error that should only occur when an editor is mucking about in Module:Currency/Presentation. It indicates that Module:Currency doesn't know where to place the currency's symbol in relation to its value.
• – an internal error that should only occur when an editor is mucking about in Module:Currency/Presentation. It indicates that Module:Currency doesn't have a page that it can use to link the currency's symbol or name.

TemplateData

以下是該模板的模板資料，適用於視覺化編輯器等工具。

Currency模板資料

沒有描述。

模板參數[編輯模板資料]

此模板以參數行內格式為優先。

參數		描述	類型	狀態
Amount	1 amount Amount	The value in the given currency	行	必填
Currency	2 code type Type	The currency represented. Should be a valid ISO 4217 code or one of the special codes listed on the template’s page 預設 USD 範例 USD	行	建議
Long form	first	When set to any value, produces a long-form currency name. This should be used for the first mention of a currency within the article	行	非必填
Link currency	linked	Whether to link to the article on that currency. 「no」 suppresses the link, any other value displays it 預設 yes 範例 no	行	非必填
Format	fmt	Specifies how value digit-groups are separated: commas, gaps or none 預設 commas 範例 gaps	行	非必填
Passthrough	passthrough	If "yes", put the string in Amount directly after its symbol without turning it into a number. 預設 no 範例 yes	行	非必填

參見

• {{Format price}}, a template that handles rounding and "big number" formatting
• {{Inflation}}, a template that adjusts historical costs to current (or other-year) equivalent value
• {{Infobox currency}}

上述文件嵌入自Template:Currency/doc。 (編輯 | 歷史)
編者可以在本模板的沙盒 (建立 | 鏡像)和測試樣例 (建立)頁面進行實驗。
請在/doc子頁面中添加分類。 本模板的子頁面。