Cingak wit saking Mal:Val/doc

{{Documentation subpage}}
{{High-use| 16851 }}
{{COinS safe|n}}
{{Lua|Module:Val}}

Template keanggén nyajiang nilai ring [[notasi ilmiah]], rumasuk sané nénten kapastika lan/utawi satuan, sekadi sané katentuang olih Wikipédia [[WP:MOSNUM|Manual of Style]].

== Pemahbah ==

Val spesialisasi ring ''nilai'' numerik, kautama sané nganggén [[notasi ilmiah]], [[kanénten pastika#Pengukuran|notasi nénten kapastika]], taler sané medué ''nilai'' nganggén satuan fisik. Mawinan keatur olih ''Manual of Style'', Val ngaryaning luaran sané karereh taler nénten karusak antuk garis.

Nyatayang angka:
* <code>&#123;{val|123456.78901}}</code> → ''nilai'', kaformat nganggé gap: {{val|123456.78901}}, utawi nganggén {{para|fmt|commas}} → {{val|fmt=commas|123456.78901}}
* <code>&#123;{val|''number''|''number''}}</code> → ''nilai'' ± ''nénten kapastika'',  sekadi {{val|fmt=commas|123478|56}}
* <code>&#123;{val|''number''|{{hilite|(}}''number''{{hilite|)}}}}</code> → ''nilai''(''nénten kapastika''), sekadi {{val|fmt=commas|12345|(56)}}
* <code>&#123;{val|''number''|''number''|''number''}}</code> →''nilai'' {{su|p=+uncertainty|b=−uncertainty}} sekadi {{val|fmt=commas4|1234|+56|-78}}

Nyatayang nilai pengukuran: {{#invoke:DemoTemplate|val|4|ul=m2}}.  <kbd>m2</kbd> silih tunggil "kode satuan" sané keanggén Val antuk ngerereh tautan ring artikel satuan taler dados pemformatan simbol satuan. Val nautang unit ring kaca sané wénten ring berkas antuk ipun. Cingak {{tl|Val/list}}.

Wénten kode satuan san3 Val uning miwah keanggén "util code". Kode satuan punika aran satuan sané kasingkat, sakéwanten puniki prasida keangén satuan gabungan utawi satuan, Cingak [[Module:Val/units]].

Wénten fléksibilitas kode-satuan sané prasida nganggén papat paraméter mekarya ring sistem kode-satuan: napiké pacang ngubungang siki utawi nénten, (cingak ''[[WP:Overlinking|Overlinking]]''), taler napiké pacang ngubungan pembilang utawi penyebut rasio satuan sané kapisah.
* <code>&#123;{val|''number''|'''ul='''''unit code''}}</code> → ''angka {{font color|blue|simbol}}'', sekadi {{val|9.8|ul=km2}}
* <code>&#123;{val|''number''|'''u='''''unit code''}}</code> → ''simbol&nbsp;angka'', sekadi {{val|9.8|u=km2}}
* <code>&#123;{val|''number''|'''u='''''unit code''|'''u{{hilite|p}}l='''''unit code''}}</code> → ''simbol''&nbsp;kode{{big|{{hilite|/}}}}{{font color|blue|simbol}}, sekadi {{val|9.8|u=gal|upl=min}}
* <code>&#123;{val|''number''|'''ul='''''unit code''|'''u{{hilite|p}}='''''unit code''}}</code> → ''simbol''&nbsp;{{font color|blue|simbol}}{{big|{{hilite|/}}}}''angka'', sekadi {{val|9.8|ul=parsec|up=year}}

Antuk mintasin sistem kode satuan, ri kala {{para|u}} nénten nguningin kode satuan Idané, ipun pacang narima wikitext taler ngarénder sekadi biasan3.
* {{#invoke:DemoTemplate|val|5.4|u=[[kg]]&sdot;[[meter|m]]/s<sup>2</sup>}}
* {{#invoke:DemoTemplate|val|7.6|u=[[méter per detik kuadrat|m/s<sup>2</sup>]]}}
Cingak [[Module:Val/units]] antuk cara nambahin satuan ring sistem kode satuan.

Wénten angka miwah kode satuan nénten cukup. Awalan utawi akhiran malih kasedia, {{para|p}} miwah {{para|s}}.
* {{#invoke:DemoTemplate|val|7600|u=  C&sdot;Ga  |p= > | s= < }}
* {{#invoke:DemoTemplate|val|7600|u=C|p=<span style="color:green"><sup>|s=</sup></span>}}

Cingak {{tl|val/testcases}} antuk ngawikanin paraméter val antuk conto. Puniki komprehénsif, miwah wénten luwih saking 100 conto.

== Pasogsag ==
{{details|Help:Template#Parameters}}
Val perlu tigang paraméter sané nénten perlu kecawis aran ipun.  Sané kapertama patut nilai numerik. Ritatkala angka sané kalih miwah katiga situnggil angka, ipun dados mekudang-kudang notasi sané kanénten kapastikayan, menawi paraméter nénten mearan sané kalih talér keanggén ''gramatikal'' ngabung angka kapertama miwah ketiga.

Val ngaryaning genah ring nampek paraméter sané nénten kasebut aran ipun.

{|cellspacing="15" cellpadding="0"
| style="vertical-align:top;text-align: center;" | '''Kapertama''' utawi {{para|1}} || Sejumlah notasi [[titik radix|titik desimal]] utawi ring [[notasi e]].  Dasar utama saking ekspresi Val.<br />
{{#invoke:DemoTemplate|val|1234567.1234567}}<br />
{{#invoke:DemoTemplate|val|.1234}} {{spaces|19}}(nambahin nol)<br />
{{#invoke:DemoTemplate|val|+1234}} {{spaces|20}}(menampilang tambah) <br />
{{#invoke:DemoTemplate|val|-1234}} {{spaces|20}}(nganti [[tanda hubung kurang]] antuk [[tanda kurang]])<br />
{{#invoke:DemoTemplate|val|12e34}} {{spaces|15}}([[Notasi ilmiah#Notasi E|notasi E]])<br />
|-
|style="vertical-align:top;text-align: center;"| {{para|fmt}}
| Olih default, angka kaformat antuk celah sané melasin kelompok tigang digit ring wagian wilangan bunter miwah pecahan.<br />
Menawi, olih default, wilangan bunter papat digit nénten kaformat; ngangén {{para|fmt|gaps}} antuk ngemaksa celah.<br />
Anggén {{para|fmt|commas}} antuk ngewatesin wagian wilangan bunter saking angka nganggén koma.<br />
Anggén {{para|fmt|none}} antuk nénten ngeformat (nénten wénten gap utawi koma).<br />
{{#invoke:DemoTemplate|val|1234567.1234567}}<br />
{{#invoke:DemoTemplate|val|1234567.1234567|fmt=commas}}<br />
{{#invoke:DemoTemplate|val|1234}}<br />
{{#invoke:DemoTemplate|val|1234|fmt=gaps}}<br />
{{#invoke:DemoTemplate|val|1234.5}}<br />
{{#invoke:DemoTemplate|val|1234.5|fmt=none}}
|-
| style="vertical-align:top;text-align: center;" | {{para|end}} || Genahan sesuatu ring akhir nomor utama (sedurung sané tiosan prasida nyarengin). <br />
{{#invoke:DemoTemplate|val|11|end=<END>}}<br />
{{#invoke:DemoTemplate|val|11|22|end=<END>}}<br />
{{#invoke:DemoTemplate|val|1111|(22)|end=<END>}}<br />
{{#invoke:DemoTemplate|val|11|22|33|end=<END>}}<br />
{{#invoke:DemoTemplate|val|11|ul=m/s|end=<END>}}
|-
| style="vertical-align:top;text-align: center;" | '''Kaping kalih''' utawi {{para|2}} || [[kanénten pastikayan#Pengukuran|kanénten pastikayan]] ngangén format napi dados.<br />
{{#invoke:DemoTemplate|val|11|22}}<br />
{{#invoke:DemoTemplate|Val|11|(22)}}<br />
Gabungan antuk ngabungang kalih angka. Mwiguna natuk rentang, luaran tata basa, mst.<br />
{{#invoke:DemoTemplate|val|11|-|33}}<br />
{{#invoke:DemoTemplate|val|11|–|33}}<br />
{{#invoke:DemoTemplate|val|11|,|33}}<br />
{{#invoke:DemoTemplate|val|11|by|33|e=9}}<br />
{{#invoke:DemoTemplate|val|11|and|33|end=$}}<br />
{{#invoke:DemoTemplate|val|11|or|33}}<br />
{{#invoke:DemoTemplate|val|11|to|33}}<br />
{{#invoke:DemoTemplate|val|11|x|33}}<br />
{{#invoke:DemoTemplate|val|11|×|33}}<br />
{{#invoke:DemoTemplate|val|11|/|33|ul=m/s}}<br />
Rengain antuk tanda hubung utawi x, sajebag ipun polih luaran sané patut.
|-
| style="vertical-align:top;text-align: center;" | '''Kaping tiga''' utawi {{para|3}}
| Kanénten pastikayan asimetris.<br />
{{#invoke:DemoTemplate|Val|11|22|33}}
|-
|style="vertical-align:top;text-align: left;"|{{para|errend}} utawi {{para|+errend}} miwah {{para|-errend}}|| Nambahin situnggil risampuné Kanénten pastikayan.<br />
{{#invoke:DemoTemplate|val|11|22|errend=<Errend>}}<br />
{{#invoke:DemoTemplate|val|11|22|33|-errend=<−Errend>|+errend=<+Errend>}}
|-
| style="vertical-align:top;text-align: center;" | {{para|u}} or {{para|ul}} || [[Template:Val/units|The unit code]].  Val nambahang spasi miwah satuan.<br />
{{para|ul}} Tautang satuan.<br />
{{para|u}} Nénten nautang satuan. Taler narima [[help:wiki markup|wiki markup]] dados penyalin kode satuan.<br />
{{#invoke:DemoTemplate|val|11|ul=m}}
|-
| style="vertical-align:top;text-align: center;" | {{para|up}} utawi {{para|upl}} || Kode unit, menawi nénten spasi, Val nambahang garis méréng miwah satuan, satuan "per" (penyebut), antuk ngewentuk rasio.<br />
{{para|upl}} Tautang per satuan.<br />
{{para|up}} Nénten nautang per satuan.<br />
Rasio prasida kadiri antuk kalih kode satuan, utawi awalan miwah kode satuan. Val pacang nambahin tanda kurung ring disambiguasi, ri kala kode satuan medué titik utawi garis méréng.<br />
{{#invoke:DemoTemplate|Val|11|ul=J/C|upl=F/m}}<br /> {{#invoke:DemoTemplate|Val|11|p=$|upl=acre}}<br />
{{#invoke:DemoTemplate|Val|11|ul=km/s|upl=Mpc}}<br />
{{#invoke:DemoTemplate|Val|11|ul=kg.m|upl=s-2}}
|-
| style="vertical-align:top;text-align: center;" | {{para|p}}  || Awali sajebang ekspresi Val. Non-spasi, menawi narima markup.<br />
{{#invoke:DemoTemplate|Val|11|22|ul=m/s|p=<Prefix>}}<br />
{{#invoke:DemoTemplate|Val|11|22|ul=m/s|p=<Prefix>&nbsp;}}
|-
| style="vertical-align:top;text-align: center;" | {{para|s}}  || Sufiks sajebag ekspresi Val. Non-spasi, menawi narima markup.<br />
{{#invoke:DemoTemplate|Val|11|22|ul=m/s|s=<Suffix>}}<br /> {{#invoke:DemoTemplate|Val|11|22|ul=m/s|s=&nbsp;<Suffix>}}
|-
| style="vertical-align:top;text-align: center;" | {{para|e}}
| Éksponen. Dados alternatif narima notasi ring paraméter kapertama; puniki éksklusif (cingak pesogsag "kapertama" ring duur).<br />
{{#invoke:DemoTemplate|Val|11|22|33|e=11}}<br />
{{#invoke:DemoTemplate|Val|11e11|22|33}}
|-
| style="vertical-align:top;text-align: center;" | {{para|long scale}}  || Biasa nyané situnggil satuan punika éndep sekadi [[ton]] miwah [[miliar]] arti nyané {{val|1|e=9}}.  Menawi wentén versi lantang saking satuan punika taler tiosan. Nganggén {{para|long scale|on}} antuk netapang santuan Idadané dados penyalin ring skala lantang. Tautan kode satuan pacang kauwah miwah pacang kawatek sané matiosan ring tabel. "Cingak [[skala lantang miwah endep]]".
|-
| style="vertical-align:top;text-align: center;" | {{para|nocategory}}  || Rikala kasetél ring nilai napi dadosné, kaiwangan ring kewigunaan  templat puniki nénten pacang ngaryanin kaca katambahin ka kategori [[:Kategori:Kaca sané nganggén format mal iwang|Kaca sané nganggén format mal iwang]]. Puniki kawiguna antuj dokumentasi miwah kaca pangujian sané nénten perlu kabenahin.
|}

== Pikobet ==

Wentén pangecekan ketat ring validitas pasosag; sawilang pawigunaan sané iwang pacang ngasilang pikobet, sané katampilang nganggén {{tl|FormattingError}}. Kaca sané medué pikobet pengangge mal puniki pacang tampil ring [[:Kategori:Kaca sané nganggé format mal iwang]].

Val meriksa paraméter sané nénten kadukung miwah nyawis peringatan sané relatif alus tikala katemu. Cingak [[:Kategori:Kaca sané nganggé format mal iwang|kategori pelacakan]] anggén ngelacak sajebag kaiwangan ring wiki. Klik mouse ring duur "Pengajin" antuk nyungakin detail nyané. Sekadi napi wentuk pengajin punika:
*<code><nowiki>{{val|1.23|exp=6|u=m/s}}</nowiki></code> → {{val|1.23|exp=6|u=m/s|nocategory=true}}
*<code><nowiki>{{val|1.23|us=kbit/s}}</nowiki></code> → {{val|1.23|us=kbit/s|nocategory=true}}
*<code><nowiki>{{val|1.23|.05|.04|.03|u=m/s}}</nowiki></code> → {{val|1.23|.05|.04|.03|u=m/s|nocategory=true}}

== Format angka ==

{{tl|Val}} ngasilang pemformatan sané sepatutné olih Wikipédia [[WP:MOSNUM|Manual of Style]].

[[Wikipedia:MOSNUM#Delimiting (grouping of digits)|MOS]] ngerekoméndasiyang pinaka angka-angka becik kewatesin nganggén spasi tipis ring kekalih sisi desimal, utawi koma ring kiwa taler nénten wénten pewates ring sisi kenawan.  Artikel patut konsistén selanturnyané antuk gaya pewatesan. Default mal ring gaya sadurungné, puniki prasida keanggén <code>|fmt=</code> (cingak [[#Pesogsag|duur]]).

== Wantek ==
{{details|Help:Sorting}}

Kunci wantek antuk sewilang satuan sané prasida kasortir kacingak ring [[Template:Val/list]].

Puniki conto langsung sané nikayang markup minimal antuk tabel sané prasida kawantek:

{|
|style="vertical-align:top;" |
<pre>
{| class="sortable"
! Val tes wantek
! Rung satuan dasar
|-
| {{val|3|ul=  Mm }}
| {{val|3000000|u=m}}
|-
| {{val|4e6|ul= m }}
| {{val|4000000|u=m}}
|-
| {{val|1|ul=  km }}
| {{val|1000|u=m}}
|-
| {{val|5e3|u=  m }}
| {{val|5000|u=m}}
|-
| {{val|2|u=    m }}
| {{val|2|u=m}}
|}
</pre>
| style="vertical-align:top;" |<!--
-->
{| class="wikitable sortable floatright" summary="Val tes kawantekan"
|+ Klik antuk wantek ↓
|-
! Val tes wantek
! Ring satuan dasar
|-
| {{val|3|ul=  Mm }}
| style="text-align:right" | {{val|3000000|u=m}}
|-
| {{val|4e6|ul= m }}
| style="text-align:right" | {{val|4000000|u=m}}
|-
| {{val|1|ul=  km }}
| style="text-align:right" | {{val|1000|u=m}}
|-
| {{val|5e3|u=  m }}
| style="text-align:right" | {{val|5000|u=m}}
|-
| {{val|2|u=    m }}
| style="text-align:right" | {{val|2|u=m}}
|}
|}

Nilai sané kekait sareng ekspresi Val minakadi.
# Nilai numerik punika titik awal.
# Rikala unit medué Awalan SI, wantekan ageng nyané katentuang.
# Nilai satuan saking [[sistem unit]] sané katetapang soang-soang.
# Rikala satuan puniki komposit, sawilang subsatuan kakaliyanh utawi kawagi per [[Analisis Dimensi#Definisi|dimensi]] ipun.
# Hasil nyané katerusang ring {{tl | ntsh}} sané nerapang rumus normalisasi.
# Luaran {{tlf | ntsh}} katambahang (wantah saking parilaksana, sekadi "Mengkeb") ring jero tabel sekadi biasa, saking atribut data-sort-value ring tabel.

== Luwih akéh conto ekspresi ==

=== Angka ===
{{#invoke:DemoTemplate|val|1234567.1234567}}<br />
<code>.{<nowiki/>{val|{{spaces|2}}1234567.1234567{{spaces|3}}}}.</code> → .{{val| 1234567.1234567 }}.<br />
{{#invoke:DemoTemplate|val|fmt=commas|.1234567}}<br />
{{#invoke:DemoTemplate|val|fmt=commas|+1234567}}<br />
{{#invoke:DemoTemplate|val|-1234567}}<br />

===Kanénten pastikayan===
{{#invoke:DemoTemplate|val|1.234|0.005}}<br >
{{#invoke:DemoTemplate|val|1.234|0.005|e=3}}<br >
{{#invoke:DemoTemplate|val|1.234|+0.005|-0.006}}<br >
{{#invoke:DemoTemplate|val|1.234|(5)}}<br >

===Satuan===
{{#invoke:DemoTemplate|val|1.234|u=m}}<br >
{{#invoke:DemoTemplate|val|1.234|u=m2}}<br >
{{#invoke:DemoTemplate|val|1.234|ul=m}}<br >
{{#invoke:DemoTemplate|val|123.4|ul=USgal}}<br >
{{#invoke:DemoTemplate|val|12.34|ul=mpgimp}}<br >

{{#invoke:DemoTemplate|val|12.34|u=deg}}<br >
{{#invoke:DemoTemplate|val|1.234|0.005|u='}}<br >
{{#invoke:DemoTemplate|val|1.234|+0.005|-0.006|u="}}<br >

{{#invoke:DemoTemplate|val|1.234|u=%}}<br >
{{#invoke:DemoTemplate|val|1.234|end=&nbsp;[[m/s]]}}<br >

{{#invoke:DemoTemplate|val|12.34|u=degC}}<br >
{{#invoke:DemoTemplate|val|12.34|u=K}}<br >

===Eksponen===
{{#invoke:DemoTemplate|val|1.234e5|ul=m}}<br >
{{#invoke:DemoTemplate|val|1.234|e=5|ul=m}}

{{#invoke:DemoTemplate|val|1.234e7|0.056}}<br >
{{#invoke:DemoTemplate|val|1.234|0.056|e=7}}

{{#invoke:DemoTemplate|val|1.23456e-9|+0.00007|-0.00008|ul=m/s}}<br >
{{#invoke:DemoTemplate|val|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}

{{#invoke:DemoTemplate|val|1.234e7|0.056|ul=psi}}<br >
{{#invoke:DemoTemplate|val|1.234|0.056|e=7|ul=psi}}

{{#invoke:DemoTemplate|val|1.234e-2|(5)}}<br />
{{#invoke:DemoTemplate|val|1.234|(5)|e=-2}}

===Prefiks/sufiks===
{{#invoke:DemoTemplate|val|p=Δ&nbsp;|12.34}}<br >
{{#invoke:DemoTemplate|val|p=≅|12.34|u=%}}<br >
{{#invoke:DemoTemplate|val|12.34|0.25|s=%}}<br />

===Pembilang/penyebut===
{{#invoke:DemoTemplate|val|1.234|e=7|ul=W|up=m2}}<br />

===Pangulangan digit===
<code><nowiki>{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}}</nowiki></code> → {{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}}

===Luwih akéh conto tiosan===
Cingak ''testcases'' ring {{tl|val/testcases}}.

== Cingak malih ==
* [[Module:Val]]
* [[Module:Val/units]]
* [[Module:Convert/data]]
* [[Template:Gaps]]
* [[Template:Decimals]]
* [[Template:Rnd]]
* [[Template:Scinote]] antuk nampilang nilai ring notasi ilmiah
* [[Template:10^]] antuk nampilang pangkat dasa
<includeonly>{{basepage subpage| <!-- Categories below this line, please: -->
[[Kategori:Mal peformatan matematika]]
[[Kategori:Mal superskrip miwah subskrip]]
[[Kategori:Mal konversi-sekadi|{{SUBPAGENAME}}]]
[[Kategori:Mal wantek]]
}}</includeonly>

== Data Mal ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Number",
			"description": "Angka ring notasi titik desimal utawi ring notasi. Dasar utama saking ekspresi Val.",
			"example": "-12.12345e9",
			"type": "string",
			"required": true
		},
		"2": {
			"label": "Kanénten pastikanyan",
			"type": "string"
		},
		"3": {
			"label": "Kanénten pastikanyan asimetris-",
			"type": "string"
		},
		"4": {},
		"5": {},
		"fmt": {
			"label": "Format",
			"description": "Saking default, angka kaformat nganggén gap sané ngemelasang kalompok tigang digit ring wagian wilangan bunter miwah pecahan. Menawi, saking default, wilangan bunter papat digit nénten kaformat; nganggén \"gaps\" (nénten nganggén tanda kutip) antuk memaksa gap. Anggén nilainya \"commas\" (nénten nganggén tanda kutip) antuk ngewatesin wagian wilangan bunter saking angka nganggén koma. Anggén \"none\" (nénten nganggén tanda kutip) antuk nénten ngeformat (nénten nganggén gap utawi koma).",
			"example": "koma",
			"type": "string"
		},
		"end": {
			"label": "Puput",
			"description": "Nganggén sesuatu ring untat nomor utama (sadurung wénten nyarengin).",
			"type": "string"
		},
		"u": {
			"label": "Satuan",
			"description": "Kode satuan. Ruang miwah satuan pacang ketambahang sesampuné nomor.",
			"example": "m",
			"type": "string"
		},
		"ul": {
			"label": "Satuan – wikilinked",
			"description": "Kode satuan sané pacang ketautang ring kaca sareng informasi satuan. Ruang miwah satuan puniki katambah sesampuné nomor.",
			"example": "m",
			"type": "string"
		},
		"up": {
			"label": "Satuan patut kaawalin antuk garis méréng (/)",
			"description": "Kode satuan, nganggén mal nambahang garis méréng miwah satuan, \"per\" satuan (penyebut), antuk ngewentuk rasio.",
			"example": "s",
			"type": "string"
		},
		"upl": {
			"label": "Satuan sané kaawalin antuk garis méréng (/) – wikilinked",
			"description": "Kode satuan ketautan, sané nambahang garis méréng miwah satuan, \"per\" satuan (penyebut), antuk ngewentuk rasio.",
			"example": "s",
			"type": "string"
		},
		"p": {
			"label": "Prefiks",
			"description": "Prefiks antuk sajebag ekspresi Val. Non-spasi, sakéwanten narima markup.",
			"type": "content"
		},
		"s": {
			"label": "Sufiks",
			"description": "Suffix antuk sajebag ekspresi Val. Non-spasi, sakéwanten narima markup.",
			"type": "content"
		},
		"e": {
			"label": "Eksponen",
			"description": "Val utawu narima notasi ring paraméter kapertama; puniki saling eksklusif (cingak paraméter Nomor).",
			"example": "9",
			"type": "number"
		},
		"errend": {}
	},
	"paramOrder": [
		"1",
		"2",
		"3",
		"fmt",
		"end",
		"u",
		"ul",
		"up",
		"upl",
		"p",
		"s",
		"e",
		"errend",
		"4",
		"5"
	],
	"format": "inline",
	"description": "Mal puniki keanggén antuk ngemudahang nyajiang nilai ring notasi ilmiah, rumasuk kanénten pastikayan lan/utawi satuan, seuningné katentuang olih Wikipedia's Manual of Style."
}
</templatedata>