کينډۍ:پولي واحد

کينډۍ لاسوند[کتل] [سمول] [پېښليک] [حافظه سپينول]

دا لوا کاروي:

د اسعارو ارزښت د مناسب سمبول سره چې د اسعارو په اړه مقالې سره تړاو لري فارمیټ کوي. که چېرې پولي واحد نامالوم وي،نو کينډۍ به ښکاره شي مقدار په د متحده ایالاتو ډالر.

کارول

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}}

کينډۍ:Currency

|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

د غیر معیاري اسعارو کوډونو ملاتړ

هغه کوډونه چې د ISO 4217 اسعارو ته ژباړل کیدی شي

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

EGE
EU
EURO
FRW
KSH
NEP
POUND
POUND STERLING
RMB
STERLING
STG
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}} gives: کينډۍ:Currency for the Bermudian dollar
{{Currency|1000|BDT}} gives: کينډۍ:Currency for the Bangladeshi taka
{{Currency|1000|AMD}} gives: کينډۍ:Currency for the Armenian dram

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

{{Currency|1000|US}} gives: کينډۍ:Currency
{{Currency|1000|United States}} gives: کينډۍ:Currency
{{Currency|1,000|JPY}} gives: کينډۍ:Currency

Parameter names can also be used, if preferred:

{{Currency|amount=1000|code=US}} gives: کينډۍ:Currency
{{Currency|1000|code=euro}} gives: کينډۍ:Currency

Negative amount:

{{Currency|amount=-1000|code=US}} gives: کينډۍ:Currency

Text quantifiers:

{{Currency|1000 million|code=euro}} gives: کينډۍ:Currency
{{Currency|1000M|code=euro}} gives: کينډۍ:Currency

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}} gives: کينډۍ:Currency
{{Currency|1000|cve}} gives: کينډۍ:Currency

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}} gives: کينډۍ:Currency

{{Currency|1000|dkk2}} gives: کينډۍ:Currency
For NOK:
{{Currency|1000|NOK}} gives: کينډۍ:Currency

{{Currency|1000|NOK2}} gives: کينډۍ:Currency
For SEK:
{{Currency|1000|SEK}} gives: کينډۍ:Currency

{{Currency|1000|SEK2}} gives: کينډۍ:Currency

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

{{Currency|1|LSL}} gives: کينډۍ:Currency

{{Currency|1000|LSL2}} gives: کينډۍ:Currency
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}} gives: کينډۍ:Currency
|fmt=gaps
{{Currency|1000 million|code=euro|fmt=gaps}} gives: کينډۍ:Currency
|fmt=none
{{Currency|1000 million|code=euro|fmt=none}} gives: کينډۍ:Currency

Passthrough:

|passthrough=yes
{{Currency|6 million|PHP|passthrough=yes}} gives: کينډۍ:Currency

{{Currency|6 trillion|PHP|passthrough=yes}} gives: کينډۍ:Currency

{{Currency|6 tn|PHP|passthrough=yes}} gives: کينډۍ:Currency
|passthrough=no
{{Currency|6 million|PHP|passthrough=no}} gives: کينډۍ:Currency

{{Currency|6 trillion|PHP|passthrough=no}} gives: کينډۍ:Currency

{{Currency|6 tn|PHP|passthrough=no}} gives: کينډۍ:Currency (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 .

Error messages

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

{{currency}} – invalid code – 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.
{{currency}} – invalid amount – 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.
{{currency}} – definition missing position – 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.
{{currency}} – definition missing page – 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

This is the TemplateData documentation for this template used by VisualEditor and other tools.

کينډۍ:Template error report

TemplateData for پولي واحد

Use this template to provide a linked currency symbol and the amount of cash.

Template parameters[TemplateData مهارول]
This template prefers inline formatting of parameters.
Parameter		څرگندونه	Type	دريځ
Amount	`1` `amount` `Amount`	The value in the given currency	کرښه	required
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	کرښه	suggested
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	کرښه	optional
Link currency	`linked`	Whether to link to the article on that currency. “no” suppresses the link, any other value displays it تلواليز yes بېلگه no	کرښه	optional
Format	`fmt`	Specifies how value digit-groups are separated: commas, gaps or none تلواليز commas بېلگه gaps	کرښه	optional
Passthrough	`passthrough`	If "yes", put the string in Amount directly after its symbol without turning it into a number. تلواليز no بېلگه yes	کرښه	optional