Wikipedia:Lua/Modul/FormatNum/en - Versionsgeschichte

PerfektesChaos: +

2019-06-19T21:28:01Z

← Nächstältere Version		Version vom 19. Juni 2019, 23:28 Uhr
Zeile 100:		Zeile 100:
	* local version otherwise, or registered on Wikidata (<code>{{#invoke:FormatNum\|failsafe\|wikidata}}</code>) when <code>wikidata</code>		* local version otherwise, or registered on Wikidata (<code>{{#invoke:FormatNum\|failsafe\|wikidata}}</code>) when <code>wikidata</code>

			== Formatierungsoptionen ==
⚫	=== Examples and test page ===
			{\| class="wikitable" style="text-align: center;"
			! Format
			! Decimal<br/> separator
			! Thousands<br/> separator<br/> (Tsep)
			! Tsep from<br/> length
			! Tsep just<br/> integer<br/> part
			!colspan="2"\| Examples
			\|-
			\| '''de'''
			\| <strong style="font-size:2em;">,</strong>
			\| Thin whitespace
			\| 5*
			\| no
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|de}}<br/>{{#invoke: FormatNum\|format\|1234.567\|de}}<br/>{{#invoke: FormatNum\|format\|12345.678\|de}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|de}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|de}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|de}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|de}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|de}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|de}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|de}}
			\|-
			\| '''de_currency'''<br/>''dewiki''
			\| <strong style="font-size:2em;">,</strong>
			\| <strong style="font-size:2em;">.</strong>
			\| 5
			\| yes
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|de_currency}}<br/>{{#invoke: FormatNum\|format\|1234.567\|de_currency}}<br/>{{#invoke: FormatNum\|format\|12345.678\|de_currency}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|de_currency}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|de_currency}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|de_currency}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|de_currency}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|de_currency}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|de_currency}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|de_currency}}
			\|-
			\| '''ch'''
			\| <strong style="font-size:2em;">,</strong>
			\| <strong style="font-size:2em;">'</strong>
			\| 5
			\| yes
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|ch}}<br/>{{#invoke: FormatNum\|format\|1234.567\|ch}}<br/>{{#invoke: FormatNum\|format\|12345.678\|ch}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|ch}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|ch}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|ch}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|ch}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|ch}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|ch}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|ch}}
			\|-
			\| '''ch_currency'''
			\| <strong style="font-size:2em;">.</strong>
			\| <strong style="font-size:2em;">'</strong>
			\| 5
			\| yes
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|1234.567\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|12345.678\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|ch_currency}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|ch_currency}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|ch_currency}}
			\|-
			\| '''en'''
			\| <strong style="font-size:2em;">.</strong>
			\| <strong style="font-size:2em;">,</strong>
			\| 4
			\| yes
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|en}}<br/>{{#invoke: FormatNum\|format\|1234.567\|en}}<br/>{{#invoke: FormatNum\|format\|12345.678\|en}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|en}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|en}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|en}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|en}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|en}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|en}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|en}}
			\|-
			\| '''iso31_0'''<br/>''at''</br>
			\| <strong style="font-size:2em;">,</strong>
			\| Thin whitespace
			\| 4
			\| no
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|1234.567\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|12345.678\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|iso31_0}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|iso31_0}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|iso31_0}}
			\|-
			\| '''iso31_0_point'''
			\| <strong style="font-size:2em;">.</strong>
			\| Thin whitespace
			\| 4
			\| no
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|1234.567\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|12345.678\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|iso31_0_point}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|iso31_0_point}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|iso31_0_point}}
			\|-
			\| '''pc'''
			\| <strong style="font-size:2em;">.</strong>
			\|
			\|
			\|
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|pc}}<br/>{{#invoke: FormatNum\|format\|1234.567\|pc}}<br/>{{#invoke: FormatNum\|format\|12345.678\|pc}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|pc}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|pc}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|pc}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|pc}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|pc}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|pc}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|pc}}
			\|-
			\| '''comma'''
			\| <strong style="font-size:2em;">,</strong>
			\|
			\|
			\|
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|123.456\|comma}}<br/>{{#invoke: FormatNum\|format\|1234.567\|comma}}<br/>{{#invoke: FormatNum\|format\|12345.678\|comma}}<br/>{{#invoke: FormatNum\|format\|1234.5678\|comma}}<br/>{{#invoke: FormatNum\|format\|12345.5678\|comma}}
			\|style="text-align:right"\| {{#invoke: FormatNum\|format\|-123.456\|comma}}<br/>{{#invoke: FormatNum\|format\|-1234.567\|comma}}<br/>{{#invoke: FormatNum\|format\|-12345.678\|comma}}<br/>{{#invoke: FormatNum\|format\|-1234.5678\|comma}}<br/>{{#invoke: FormatNum\|format\|-12345.5678\|comma}}
			\|}
			<nowiki />* Since the thousands separator is applied to the part after decimal separator, a length of 5 is relevant only if there is a part after decimal separator with maximal 3 digits. On 4 or more digits after decimal separator the integer part will be divided also on 4 digits.

		⚫	== Examples and test page ==
	There are [[:de:Wikipedia:Lua/Modul/FormatNum/Test\|tests available]] to illustrate this in practice.		There are [[:de:Wikipedia:Lua/Modul/FormatNum/Test\|tests available]] to illustrate this in practice.

PerfektesChaos: +

2019-06-19T20:47:16Z

@@ Zeile 3: / Zeile 3: @@
 == Functions for templates ==
 === failsafe ===
@@ Zeile 46: / Zeile 135: @@
 ; FormatNum.format(assert)
 :* assert: optional string
 ; FormatNum()
 : Yields ''table'' with access to functions (see above).

PerfektesChaos: Setup

2019-06-19T18:51:45Z

Setup

Neue Seite

{{LuaModuleDoc}}
'''<code>FormatNum</code>''' – Module containing methods for rounding and formatting of numbers. Various variants are offered.

== Functions for templates ==

=== failsafe ===
Version ID: <code>{{#invoke:FormatNum|failsafe}}</code>
* optional parameter <code>1</code> – required version, or keyword <code>wikidata</code>
''Returns:''
* (empty), if minimal version condition not matched
* local version otherwise, or registered on Wikidata (<code>{{#invoke:FormatNum|failsafe|wikidata}}</code>) when <code>wikidata</code>

=== Examples and test page ===
There are [[:de:Wikipedia:Lua/Modul/FormatNum/Test|tests available]] to illustrate this in practice.

== <span id="Lua">Use in another Lua module</span> ==
All of the above functions can be called from other Lua modules, if not Lua library function anyway. Use <code>require()</code>; the below code checks for errors loading it:
<syntaxhighlight lang="lua">
local lucky, FormatNum = pcall( require, "Module:FormatNum" )
if type( FormatNum ) == "table" then
FormatNum = FormatNum.FormatNum()
else
-- In the event of errors, FormatNum is an error message.
return "<span class=\"error\">" .. FormatNum .. "</span>"
end
</syntaxhighlight>

; FormatNum.format(source, spec, meet)
:* source: string
:* spec: optional string
:* meet: optional number (extension for internal padding)
; FormatNum.minus(source, larger)
:* source: string
:* larger: optional boolean (conversion into Unicode)
; FormatNum.padding(source, meet, stop)
:* source: string
:* meet: number
:* stop: string
; FormatNum.roman2number(source, suffix)
:* source: string
:* suffix: optional string
; FormatNum.round(source, precision, method)
:* source: string
:* precision: number
:* method: optional number
; FormatNum.format(assert)
:* assert: optional string
; FormatNum()
: Yields ''table'' with access to functions (see above).

== Internals ==

== Usage ==
This is a general library; use it anywhere. Dedicated to be wrapped into relevant templates.

== Dependencies ==
None.

[[Kategorie:Wikipedia:Lua/Modul/Dokumentation|FormatNum/en]]