سانچو:Currency/doc

Related pages
Template (talk) Template sandbox Template testcases Template doc Template subpages Module (talk) Module sandbox Module testcases Module doc Module subpages

هي سانچو ڪرنسي جي قيمت کي مناسب نشان سان فارميٽ ڪري ٿو، جيڪو انهيءَ ڪرنسي بابت مضمون سان ڳنڍيل هوندو آهي. جيڪڏهن ڪا ڪرنسي مقرر نه ڪئي وڃي، ته سانچو رقم کي آمريڪي ڊالرن ۾ ڏيکاريندو.

استعمال

بي نالي پيراميٽرن سان:

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

نالي وارن پيراميٽرن سان:

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

جتي:

value هڪ انگ آهي، جيڪو ڪاما ڌار ڪندڙن سان يا بغير ٿي سگهي ٿو؛ ان جي پٺيان اختياري مقدار ڏيکاريندڙ لفظ به اچي سگهي ٿو: 'ھزار'، 'ملين'، 'M'، 'بلي.'، 'B'، يا 'ٽرلين'.

code هڪ آء ايس او 4217 ڪرنسي ڪوڊ آهي يا هيٺ ڏنل سهائتا يافته غير معياري ڪوڊن مان ڪو هڪ.

|first= جڏهن ڪنهن به قدر تي مقرر ڪيو وڃي ته ڪرنسي جو ڊگهو نالو ڏيکاري ٿو.

|linked= جڏهن no تي مقرر ڪيو وڃي ته ڏيکاريل ڪرنسي نشان يا ڊگهي نالي مان وڪي ڳنڍڻا بند ٿي وڃن ٿا.

|fmt= اهو طئي ڪري ٿو ته value جي انگن جا گروهه ڪيئن جدا ڪيا وڃن:

commas (ڊفالٽ) value جي انگن جا گروهه ڪامائن سان جدا ڪري ٿو؛ جڏهن |fmt= خالي يا نه ڏنو وڃي ته اهو ئي ڊفالٽ هوندو.

gaps انگن جي گروهن کي سنهڙن خالن سان جدا ڪري ٿو.

none value کي بغير گروهه بندي جي ڏيکاري ٿو.

|passthrough= اهو طئي ڪري ٿو ته سانچو |fmt= موجب انگ کي پڙهڻ جي ڪوشش ڪري يا |amount= ۾ ڏنل سٽرنگ کي سڌو ڪرنسي نشان کان پوءِ رکي. ان جي قيمت يا ته |passthrough=yes يا |passthrough=no هجڻ گهرجي.

جڏهن پيراميٽر نالا استعمال ڪيا وڃن، تڏهن |amount= ۽ |code= کي ترجيح ڏني وڃي ٿي. سانچو |Amount=، |type= ۽ |Type= به قبول ڪري ٿو.

نوٽ: نالي ۽ بي نالي ٻنهي قسمن جا پيراميٽر گڏ استعمال ڪرڻ سان اڻڄاتل نتيجا نڪري سگهن ٿا. هن مثال ۾، سانچو پهرين بي نالي پيراميٽر کي رقم سمجهي ٿو:

{{Currency|amount=1000|GBP}}

ان جي بدران {{Currency|1000|GBP}} يا {{Currency|amount=1000|code=GBP}} استعمال ڪريو، جيڪي ٻئي £1,000 نتيجو ڏين ٿا.

سهائتا يافته غير معياري ڪرنسي ڪوڊ

اهي ڪوڊ جيڪي آء ايس او 4217 ڪرنسين ۾ تبديل ٿي سگهن ٿا

اهي غير معياري ڪوڊ معياري آء ايس او 4217 ڪوڊن جا متبادل نالا آهن.

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

ٻيا غير معياري ڪوڊ

اهي ڪوڊ يا ته ڪنهن ISO 4217 ڪرنسي ڪوڊ سان نٿا ملن، يا موجود ISO 4217 ڪوڊن جا متبادل نسخا آهن، يا ڪرنسي جي مخصوص خصوصيتن لاءِ استعمال ٿين ٿا.

• بٽ ڪوائن– ڪو به لاڳاپيل آھ ايس او 4217 ڪوڊ ناهي
• BTC – ڪو به لاڳاپيل ISO 4217 ڪوڊ ناهي
• DKK2 – DKK جو متبادل نسخو
• FRF – تاريخي
• GRD – تاريخي
• LSL2 – LSL جو جمع وارو نسخو
• LTL – تاريخي
• NOK2 – NOK جو متبادل نسخو
• SEK2 – SEK جو متبادل نسخو
• SZL2 – SZL جو جمع وارو نسخو
• US$ – خاص صورت: معياري ڪوڊ "USD" (۽ "$") وانگر، پر صرف "$" ڏيکاري ٿو، ڊگهو "US$" نه
• XBT – ڪو به لاڳاپيل ISO 4217 ڪوڊ ناهي

مثال

آمريڪي ڊالر کان سواءِ ٻين ڪرنسين کي مناسب آي ايس او 4217 ڪرنسي ڪوڊ استعمال ڪري ڏيکاري سگهجي ٿو:

• {{Currency|1000|BMD}} نتيجو ڏئي ٿو: BD$1,000 برمودا ڊالر لاءِ
• {{Currency|1000|BDT}} نتيجو ڏئي ٿو: ৳1,000 بنگلاديشي ٽڪو لاءِ
• {{Currency|1000|AMD}} نتيجو ڏئي ٿو: ֏ 1,000 آرمينيائي ڊرام لاءِ

ڪجهه وڌيڪ مشهور ڪرنسين لاءِ عام مخفف يا مڪمل نالا پڻ استعمال ڪري سگهجن ٿا:

• {{Currency|1000|US}} نتيجو ڏئي ٿو: US$1,000
• {{Currency|1000|United States}} نتيجو ڏئي ٿو: US$1,000
• {{Currency|1,000|JPY}} نتيجو ڏئي ٿو: ¥1,000

پيراميٽر نالا به استعمال ڪري سگهجن ٿا:

• {{Currency|amount=1000|code=US}} نتيجو ڏئي ٿو: US$1,000
• {{Currency|1000|code=euro}} نتيجو ڏئي ٿو: €1,000

منفي رقم:

• {{Currency|amount=-1000|code=US}} نتيجو ڏئي ٿو: US$−1,000

متني مقدار:

• {{Currency|1000 million|code=euro}} نتيجو ڏئي ٿو: €1,000,000,000
• {{Currency|1000M|code=euro}} نتيجو ڏئي ٿو: €1,000,000,000

ڪرنسي جو پهريون استعمال رقم ۽ مڪمل ڪرنسي نالو ڏيکارڻ گهرجي، تنهنڪري جيڪڏهن "first" پيراميٽر مقرر ڪيو وڃي ته اهو ئي ڏيکاريو ويندو.

• {{Currency|1000|cve|first=yes}} نتيجو ڏئي ٿو: 1,000 Cape Verde escudos
• {{Currency|1000|cve}} نتيجو ڏئي ٿو: 1.000$00

ڇاڪاڻ⁠تہ DKK، NOK، ۽ SEK ڪرنسين جا نشان مبهم ٿي سگهن ٿا، تنهنڪري انهن کي ٻن طريقن سان ڏيکاري سگهجي ٿو:

• DKK لاءِ:

  {{Currency|1000|dkk}} نتيجو ڏئي ٿو: kr. 1,000

  {{Currency|1000|dkk2}} نتيجو ڏئي ٿو: DKK 1,000

• NOK لاءِ:

  {{Currency|1000|NOK}} نتيجو ڏئي ٿو: kr 1,000

  {{Currency|1000|NOK2}} نتيجو ڏئي ٿو: NOK 1,000

• SEK لاءِ:

  {{Currency|1000|SEK}} نتيجو ڏئي ٿو: kr 1,000

  {{Currency|1000|SEK2}} نتيجو ڏئي ٿو: SEK 1,000

ساڳيءَ طرح، ڪجهه ڪرنسين ۾ واحد ۽ جمع مقدار لاءِ مختلف نشان استعمال ٿين ٿا:

• {{Currency|1|LSL}} نتيجو ڏئي ٿو: L1

  {{Currency|1000|LSL2}} نتيجو ڏئي ٿو: M1,000

• سانچو في الحال اهو فرق پاڻمرادو نٿو ڪري، تنهنڪري صحيح ڪوڊ چونڊڻ ايڊيٽر جي ذميواري آهي.

انگن جي گروهه بندي

• |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}} نتيجو ڏئي ٿو: (غلطي متوقع آهي، ڇاڪاڻ⁠تہ سانچو 6 tn کي 6,000,000,000,000 طور پڙهڻ نٿو ڄاڻي)

• احتياط سان استعمال ڪريو! عام طور |fmt= وڌيڪ مناسب هوندو. |passthrough= صرف انهن حالتن ۾ استعمال ٿيڻ گهرجي جيڪي سان هم آهنگ هجن.

غلطي جا پيغام

{{currency}} ڪيترائي غلطي پيغام ڏيکاري سگهي ٿو. اهي هي آهن:

– ٻئي بي نالي پيراميٽر يا |code= ۾ ڏنل قدر سانچي جي ڪوڊن جي فهرست ۾ موجود ناهي.

– پهرين بي نالي پيراميٽر يا |amount= ۾ اهڙا اکر موجود آهن جيڪي منفي نشان، عدد، ڪاما يا اعشاري نقطي کان سواءِ آهن.

– هڪ اندروني غلطي، جيڪا عام طور تڏهن ٿيندي جڏهن ڪو ايڊيٽر ماڊيول:Currency/Presentation ۾ غير مناسب تبديليون ڪري.

– هڪ اندروني غلطي، جيڪا ظاهر ڪري ٿي ته ماڊيول:Currency وٽ اهڙو صفحو موجود ناهي جنهن سان ڪرنسي نشان يا نالو ڳنڍي سگهجي.

سانچائي ڊيٽا

هي هن سانچي لاءِ سانچائي ڊيٽا جو دستاويز آهي، جيڪو نظري ايڊيٽر ۽ ٻين اوزارن طرفان استعمال ڪيو ويندو آهي۔

سانچي ڊيٽا ھيڊر لاءِ سانچائي ڊيٽا

هن سانچي کي ڳنڍيل ڪرنسي نشان ۽ رقم ڏيکارڻ لاءِ استعمال ڪريو.

سانچي جا پيراميٽرز

هي سانچو پيرا ميٽرز جي ان لائن فارميٽنگ کي ترجيح ڏئي ٿو.

پيراميٽر		تشريح	قِسم	اسٽيٽس
رقم	1 amount Amount	ڏنل ڪرنسي ۾ رقم	سِٽَ	گهربل
ڪرنسي	2 code type Type	استعمال ٿيندڙ ڪرنسي. صحيح ISO 4217 ڪوڊ يا هن سانچي جي صفحي تي ڏنل خاص ڪوڊن مان ڪو هڪ هجڻ گهرجي ڏنل USD مثال USD	سِٽَ	تجويز ڪيل
ڊگهو روپ	first	ڪنهن به قدر تي مقرر ٿيڻ سان ڪرنسي جو ڊگهو نالو ڏيکاري ٿو. مضمون ۾ ڪرنسي جي پهرين ذڪر لاءِ استعمال ٿيڻ گهرجي	سِٽَ	اختياري
ڪرنسي ڳنڍيو	linked	ڇا ڪرنسي بابت مضمون سان ڳنڍڻو آهي يا نه. “no” ڳنڍڻو ختم ڪري ٿو، ٻيو ڪو به قدر ان کي ڏيکاري ٿو ڏنل yes مثال no	سِٽَ	اختياري
فارميٽ	fmt	طئي ڪري ٿو ته رقم جي انگن جا گروهه ڪيئن جدا ٿين: commas، gaps يا none ڏنل commas مثال gaps	سِٽَ	اختياري
Passthrough	passthrough	جيڪڏهن "yes" هجي ته Amount ۾ ڏنل سٽرنگ کي انگ ۾ تبديل ڪرڻ کان سواءِ سڌو نشان کان پوءِ رکي. ڏنل no مثال yes	سِٽَ	اختياري

پڻ ڏسو

• وڪيپيڊيا:Manual of Style (dates and numbers)#Currencies اهم استعمالي هدايتن لاءِ
• {{Format price}}، انگن کي گول ڪرڻ ۽ “وڏن انگن” جي فارميٽ لاءِ سانچو
• {{Inflation}}، تاريخي قيمتن کي موجوده يا ٻئي سال جي برابر قيمت ۾ تبديل ڪندڙ سانچو
• {{Infobox currency}}
• {{To USD}}، ڪنهن ملڪ جي قومي ڪرنسي ۾ ڏنل رقم کي آمريڪي ڊالرن ۾ تبديل ڪندڙ سانچو