ਫਰਮਾ:ISO 4217/code/doc

ਇਹ ਇੱਕ ਫਰਮਾ:ISO 4217/code ਲਈ documentation ਉਪ ਸਫ਼ਾ ਹੈ।
ਇਸ ਵਿੱਚ ਵਰਤੋਂ ਦੀ ਜਾਣਕਾਰੀ, ਸ਼੍ਰੇਣੀਆਂ ਅਤੇ ਹੋਰ ਸਮੱਗਰੀ ਜੋ ਮੂਲ ਦਾ ਹਿੱਸਾ ਨਹੀਂ ਹੈ, ਸ਼ਾਮਲ ਹੈ। ਫਰਮਾ page.

Utilising the alpha3 ISO 4217 code. For example, the code number can be derived from the code. Based on the ISO 4217 Standfard definition (per {{ISO 4217/cite}}, October 2022 ਤੱਕ ^[update]).

There are 304 unique codes (ADP..ZWR). Codes are reused (as currency in history, in history with different end-date by country, in List Two funds, in entities) resulting in 452 currency definitions (data rows).

{{ISO 4217/overview}} (P498)

General[ਸੋਧੋ]

|iso-code=

|format=

|is-obsolete=

Most parameters work by {{yesno}} principle: yes, 1, true, <anytext> and no, 0, false, <blank> are recognised as T/F.

|format=-options can be comma-separated list: |format=option-none, ISO4217-cat, mono, brackets, (as announced per template)

Base: iso-code[ਸੋਧੋ]

ISO 4217/code[ਸੋਧੋ]

{{ISO 4217/code}}

Returns valid ISO 4217 code or blank.

|iso-code=

Basic: |format=<blank> returns EITHER the code as exists OR <blank> (no tracking etc)

|format=option-none, ISO4217-cat

See § maintenance-category ISO4217

Other data (ref, comment) elsewhere. Data 17 October 2022 ਤੱਕ ^[update], per source {{ISO 4217/cite}}

iso-code error (maintenance category)[ਸੋਧੋ]

|format=ISO4217-cat will categorise articles with ISO-codes that do not exist in ISO. Sorted under C.

(When in Template space, a wikilink to the category will show: |iso-code=ZZZ → ZZZ)

See § maintenance-category ISO4217

option-none (code='None')[ਸੋਧੋ]

|format=option-none will allow |iso-code=''None'', none, no (formatting is optional).

{{ISO 4217/code-none}} will return (show) |iso-code=''None'' (as formatted).

Internally, {{ISO 4217/code-none}} returns _NONE_ or <blank>.

When code "None" is not allowed |format=option-none, |iso-code=None input is considered unrecognised code (returns blank). Will be categorised from mainspace, sorted under N.

(In Template space: |iso-code=None → None)

See § maintenance-category ISO4217

Examples[ਸੋਧੋ]

in	plain	is "None"?	`\|format=option-none` option-none=<absent>	`\|format=ISO4217-cat`	number	minor unit
`\|iso-code=USD`	USD	ਫਰਮਾ:ISO 4217/code-none	USD	USD	ਫਰਮਾ:ISO 4217/code-to-number	ਫਰਮਾ:ISO 4217/code-minor-unit
`\|iso-code=''None''`		ਫਰਮਾ:ISO 4217/code-none	None None	None	ਫਰਮਾ:ISO 4217/code-to-number	ਫਰਮਾ:ISO 4217/code-minor-unit
`\|iso-code=ZZZ`		ਫਰਮਾ:ISO 4217/code-none	aaa	aaa	ਫਰਮਾ:ISO 4217/code-to-number	ਫਰਮਾ:ISO 4217/code-minor-unit
`\|iso-code=<blank>`		ਫਰਮਾ:ISO 4217/code-none			ਫਰਮਾ:ISO 4217/code-to-number	ਫਰਮਾ:ISO 4217/code-minor-unit

Derived value templates[ਸੋਧੋ]

minor unit[ਸੋਧੋ]

"Minor unit" in ISO 4217: number of decimals for minor unit used in currency trade. For example, USD has Minor unit=2, i.e. 0.01 (dollarcent unit).

Occurring values are: <blank>, N.A., 0, 2, 3, 4. So, incidentally, 1 (for ਫਰਮਾ:Cursign 0.1) is not present. Obsolete currency (historical, List Three): has no minor unit ("blank").

{{ISO 4217/code-minor-unit}}

In enwiki: "<blank>", "N.A.", "0" all return blank, because "ਫਰਮਾ:Cursign 1" is not a subunit of "ਫਰਮਾ:Cursign 1".

|iso-code=, |is-obsolete=, |format=blank/default (0.001-form), exponent (N.A., <blank>, 0, 2, 3, 4)
Examples: <blank> AFA: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit; N.A. XPD: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit; 0 KRW: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit; 1 (not present); 2 RUB: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit; 3 OMR: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit; 4 CLF: ਫਰਮਾ:ISO 4217/code-minor-unit → ਫਰਮਾ:ISO 4217/code-minor-unit

Ambiguous code & minor units[ਸੋਧੋ]

10 codes are ambiguous: they appear both obsolete and active: |ANG|EUR|HRK|IDR|MWK|PEN|RON|SDG|SZL|TRY.

For example, PEN refers to an obsolete and an active currency. These have different exponents.; |is-obsolete=no/yes sets the right one. Default is: |is-obsolete=no (currency PEN is active}})
Example: PEN is ambiguous, required |is-obsolete= specifier.; USD is not ambiguous (active, |is-obsolete= is trivial); ESA is not ambiguous (historical, List Three; |is-obsolete= is trivial); Other not a code

PEN

|is-obsolete=1999 >ਫਰਮਾ:ISO 4217/code-minor-unit< (obsolete)

|is-obsolete=no >ਫਰਮਾ:ISO 4217/code-minor-unit< (active)

|is-obsolete= >ਫਰਮਾ:ISO 4217/code-minor-unit< (active, default)

|<absent>= >ਫਰਮਾ:ISO 4217/code-minor-unit< (active, default)

is-obsolete=1999

is-obsolete=no

is-obsolete=yes

code-to-number[ਸੋਧੋ]

{{ISO 4217/code-to-number}} ({{../format}})

Code and number are 1:1 (code=number; number=code).
Three codes defined to have no number: XFO, XFU, XRE (all obsolete)
17 October 2022 ਤੱਕ ^[update]: 304 existing unique alpha3-codes (over Lists One, Two and Three). Alphacode can have zero or one number (but not multiple). Numbers can repeat (eg ALL, ALK=008).

|format=<blank>, plain [=default]; brackets

Follows from code. Unknown code=blank. No tracking.

code-is-ambiguous[ਸੋਧੋ]

10 codes are ambiguous, they appear both obsolete and active: |ANG|EUR|HRK|IDR|MWK|PEN|RON|SDG|SZL|TRY.

For example, EUR is active in ਫਰਮਾ:Smallcaps2, and obsolete in ਫਰਮਾ:Smallcaps2 per withdrawal-date=2006-10 (List Three). 17 October 2022 ਤੱਕ .

When such code is used, disambiguation may be required (is-obsolete=yes/no), to specify which currency is intended. This is relevant with minor-unit, and manually setting (clarifying)is-obsolete. Used in {{Infobox currency}}.

|format=ISO4217-cat: The article using an ambiguous code, will be categorised, sort under A (for checking, not an error indication).

{{ISO 4217/code-is-ambiguous}}

|format=iso-code, ISO4217-cat |yes-text=anytext, <blank> (note: |yes-text=<blank> is counter-intuitive; useful for categorisation)

|yes-text=<blank> → no returntext (use for silent categorisation |ISOcat=yes)

Tracking: |ISOcat=yes: when ambiguous then → in Category:Pages using ISO 4217 currency to check (0) (catsort under A)

default USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

|ISOcat=yes → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

|yes-text=_YES-is-ambig_ → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

|yes-text=<blank> → >ਫਰਮਾ:ISO 4217/code-is-ambiguous< So status=yes, but yes-returntext is suppressed

|yes-text=<blank>, |ISOcat=yes → >ਫਰਮਾ:ISO 4217/code-is-ambiguous< So status=yes, but yes-returntext is suppressed

Extended content

USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

FOO → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

ISOcat=yes: USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; FOO → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

ISOcat=blank: USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; FOO → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

yes-text=_YES-is-ambig_: USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; FOO → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<

yes-text=<blank>: USD → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; FOO → >ਫਰਮਾ:ISO 4217/code-is-ambiguous<; PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous< So status=yes, but yes-returntext is suppressed; PEN → >ਫਰਮਾ:ISO 4217/code-is-ambiguous< So status=yes, but yes-returntext is suppressed

code-to-withdrawal-date[ਸੋਧੋ]

{{ISO 4217/code-to-withdrawal-date}}
Note: |is-obsolete=yes/no required for ambivalent currencies: ANG, EUR, HRK, IDR, MWK, PEN, RON, SDG, SZL, TRY

These codes are both in list-1 and list-3 (active and obsolete). So one must specify wheteher active (no |is-obsolete=<blank>, no or obsolete |withdr-date=1999, yes No tracking. Multiple witdrawal-dats possible

Used in {{ISO 4217/code-minor-unit}}

Not in mainspace[ਸੋਧੋ]

1 Nov 2022 ਤੱਕ

code-is-obsolete[ਸੋਧੋ]

Template:ISO 4217/code-is-obsolete (backlinks edit) returns ISO withdrawal-date or blank.
Template:ISO 4217/code-is-obsolete/calc (backlinks edit) returns ISO withdrawal-date or blank.

|iso-code, is-obsolete=

The logic[ਸੋਧੋ]

|iso-code=, determines from ISO 4217. Thew code can be ambiguous.

|is-obsolete=: yes/no (T/F), blank='unknown'

{{yesno}} is applied: |is-obsolete=no, false=no (not obsolete, so active), |is-obsolete=<any text> is yes (obsolete)

Currency is obsolete?
		`\|is-obsolete=T/F/unk`
		T=obs₀₁	F=act₀₂	unk₀₃
code `\|iso-code= ABC/unk` →`T/F/ambig/unk`
	T=obs₁₀	OBS₁₁	N→ACT₁₂	OBS₁₃
	F=act₂₀	N→OBS₂₁	ACT₂₂	ACT₂₃
	ambig₃₀	OBS₃₁	ACT₃₂	ACT (default)₃₃
	unk₄₀	OBS₄₁	ACT₄₂	ACT (default)₄₃

N Contradicting situation: Obsolete vs. Active. By default |code-priority=no, so |is-obsolete=T/F decides.

Contradiction solving[ਸੋਧੋ]

Two situations imply a contradiction: the ISO-status contradicts the entered |is-obsolete= status. This may occur when an infobox covers more than one currency. The default handling is: |is-obsolete= takes precedence. By setting |code-priority=yes gives ISO code prority (result opposite). This does not resolve the contradiction.

Currency is obsolete?
`\|code-priority=no` (default)
		`\|is-obsolete=T/F/unk`
		T=obs₀₁	F=act₀₂
code `\|iso-code=...` →`T/F/...`
	T=obs₁₀	OBS₁₁	N→ACT₁₂
	F=act₂₀	N→OBS₂₁	ACT₂₂

`\|code-priority=yes`
	N→OBS₁₂
N→ACT₂₁

Returns: when Obsolete, a text; when Active, no text (blank). On can apply this as {{#if:{{code-is-obsolete|...}}|Obsolete|Active}}.

The returntext is:

When obsolete: 1. the |is-obsolete=anytext; 2. the |withdrawal-date=, 3. |obs-text=..., 4. "OBS"

When active: 1. |act-text=... 2. <blank>

Note that, by entering a blank |obs-text=, the returntext will be a blank (so, same as default actual returntext!)

|obs-text=, |act-text= overwrites.

In {{Infobox currency}}: For |obsolete=, |obsolete= of the infobox is used: |obsolete={{{obsolete|}}}

Examples[ਸੋਧੋ]

|iso-code=, |is-obsolete=

USD, active

USD >ਫਰਮਾ:ISO 4217/code-to-withdrawal-date<

ATS, Austria shilling - withdrawn

ATS >ਫਰਮਾ:ISO 4217/code-to-withdrawal-date<

PEN, PERU Nuevo Sol (ambivalent so wsdate needed)

PEN >ਫਰਮਾ:ISO 4217/code-to-withdrawal-date< -- defaults to Active

FOO, not a code

FOO >ਫਰਮਾ:ISO 4217/code-to-withdrawal-date<

"None", not a code

noNe >ਫਰਮਾ:ISO 4217/code-to-withdrawal-date<

blank

>ਫਰਮਾ:ISO 4217/code-to-withdrawal-date<

code-entity-list[ਸੋਧੋ]

Template:ISO 4217/code-entity-list (backlinks edit) ( {{../demo}} · edit )

ਫਰਮਾ:ISO 4217/code-count/demo ਫਰਮਾ:ISO 4217/code-count/demo ਫਰਮਾ:ISO 4217/code-count/demo ਫਰਮਾ:ISO 4217/code-count/demo ਫਰਮਾ:ISO 4217/code-count/demo

edge

ਫਰਮਾ:ISO 4217/code-count/demo ਫਰਮਾ:ISO 4217/code-count/demo

code-count[ਸੋਧੋ]

Template:ISO 4217/code-count (backlinks edit)

{{ISO 4217/code-count|iso-code=|list=}}

|list, iso-code=L1, ..., L123

Number of "XYZ" code repetition per list, and over all tyhree lsits. There are 304 unique codes, repetitions make 450 different lines (code, List, entity, end-date can be repeated).

Intended for checking and listformatting only (no new information).

See § code-entity-list for demo

code-to-qid[ਸੋਧੋ]

Template:ISO 4217/code-to-qid (backlinks edit)

{{ISO 4217/code-to-qid|iso-code=|format=}}

|format=plain, wl, wl-info, <blank>

(P498), ~265, 08:58, 13 November 2022 (UTC) ਤੱਕ

Maintenance-category (ISO 4217) [ਸੋਧੋ]

Cat:Category:ISO 4217: →

{{ISO 4217/maintenance-category}}

Sets Category:Pages using ISO 4217 currency to check (0), used in various templates.

Distinguishes: mainspace (=categorise), template space (=colon-link :Category:Pages using ...), all other spaces (no effect).

{{ISO 4217/maintenance-category
|main-sort=
|template-sort=
}}

In template space: {{ISO 4217/maintenance-category}}

In the templates, activated by |ISO4217-cat= or by |format=.., ISO4217-cat, ..

Used by: {{ISO 4217/code}}, {{Infobox central bank}}, {{Infobox currency}} (projected as of October 2022)

Backoffice[ਸੋਧੋ]

The templates[ਸੋਧੋ]

Deployed in mainspace

{{/format}} · {{../testcases}}

{{ISO 4217/maintenance-category}} (Category:Pages using ISO 4217 currency to check (0))

Not yet used in / fit for mainspace

{{ISO 4217/code-to-iso-name}}
{{ISO 4217/code-to-withdrawal-date}}
{{ISO 4217/code-to-start-date}}
{{ISO 4217/code-is-obsolete}}
{{ISO 4217/code-entity-list}}
{{ISO 4217/code-to-qid}} -- curation; dated (13 Nov 2022)

todo[ਸੋਧੋ]

IB does cat eponym eg in euro

General[ਸੋਧੋ]

Base: iso-code[ਸੋਧੋ]

ISO 4217/code[ਸੋਧੋ]

iso-code error (maintenance category)[ਸੋਧੋ]

option-none (code='None')[ਸੋਧੋ]

Examples[ਸੋਧੋ]

Derived value templates[ਸੋਧੋ]

minor unit[ਸੋਧੋ]

Ambiguous code & minor units[ਸੋਧੋ]

code-to-number[ਸੋਧੋ]

code-is-ambiguous[ਸੋਧੋ]

code-to-withdrawal-date[ਸੋਧੋ]

Not in mainspace[ਸੋਧੋ]

code-is-obsolete[ਸੋਧੋ]

The logic[ਸੋਧੋ]

Contradiction solving[ਸੋਧੋ]

Examples[ਸੋਧੋ]

code-entity-list[ਸੋਧੋ]

code-count[ਸੋਧੋ]

code-to-qid[ਸੋਧੋ]

Maintenance-category (ISO 4217) [ਸੋਧੋ]

Backoffice[ਸੋਧੋ]

The templates[ਸੋਧੋ]

todo[ਸੋਧੋ]

See also[ਸੋਧੋ]