Template:Roman/sandbox

This is the template sandbox page for Template:Roman (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 3,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Preview message: Transclusion count updated automatically (see documentation).

This template uses Lua:

Module:Roman (sandbox)

This template converts Arabic numerals (that is, 1, 2, 3, etc.) into Roman numerals (I, II, III etc.). It currently works for any whole number between 1 and 4999999.

Usage

{{Roman|number|message}}

Replace number with the number you would like to be converted to Roman numerals. For numbers higher than 4999999 the template outputs "N/A". This can be changed by replacing message with your preferred text.

An overline, representing multiplication by 1000, is used to extend the upper range of the function.

See Roman numerals for further information.

Fraction support

The template can accept parsing decimals, fractions, and arithmetic expressions. This is not enabled by default. To enable this, supply |fraction=yes, i.e. {{Roman|105.5|fraction=yes}} or {{Roman|105.5|too big|fraction=yes}}.

Roman numeral output for fractional values uses these symbols:

S = 1⁄2
: = 1⁄6
• = 1⁄12
Є = 1⁄24
ƧƧ = 1⁄36
Ɔ = 1⁄48
Ƨ = 1⁄72
Ƨ = 1⁄144
℈ = 1⁄288
» = 1⁄1728
N = 0

Examples

Arabic numerals	Template call	Roman numerals
0	`{{Roman\|0}}`	N
1	`{{Roman\|1}}`	I
2	`{{Roman\|2}}`	II
49	`{{Roman\|49}}`	XLIX
50	`{{Roman\|50}}`	L
51	`{{Roman\|51}}`	LI
1024	`{{Roman\|1024}}`	MXXIV
4999	`{{Roman\|4999}}`	IVCMXCIX
5000	`{{Roman\|5000}}`	V
5001	`{{Roman\|5001}}`	VI
69105	`{{Roman\|69105}}`	LXIXCV
1048576	`{{Roman\|1048576}}`	MXLVMMMDLXXVI
4999999	`{{Roman\|4999999}}`	MMMMCMXCIXCMXCIX
7654321	`{{Roman\|7654321}}`	N/A
7654321	`{{Roman\|7654321\|too high}}`	too high

If the number provided is negative, the template will output an error message. If the first parameter provided cannot be interpreted as a number, the template will also output an error message. If no arguments are given, the template produces no output.

Decimal, fractional, and arithmetic examples

Value	Template Call	Roman Numerals
0.0005	`{{Roman\|0.0005}}`	»
20.002	`{{Roman\|20.002}}`	XX»»»
110.003472	`{{Roman\|110.003472}}`	CX℈
3+4.007	`{{Roman\|3+4.007}}`	VIIƧ
1-0.9861	`{{Roman\|1-0.9861}}`	Ƨ
4.6*2.5	`{{Roman\|4.6*2.5}}`	XIS
1/3	`{{Roman\|1/3}}`	::
9999/10000	`{{Roman\|9999/10000}}`	S:•:ЄƧƧƧ℈»»»»»
100+5.5	`{{Roman\|100+5.5}}`	CVS

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Roman in articles based on its TemplateData.

TemplateData for Roman

Convert numbers to Roman numerals.

Template parameters[Edit template data]
Parameter		Description	Type	Status
Number	`1`	The number to be converted to Roman numerals. If the parameter passed cannot be interpreted as a numerical value, no output is generated. Example 69105	Number	optional
Message	`2`	Message to display for numbers that are too big to be displayed in Roman numerals. (The largest number supported is 4999999.) Default N/A Example Too big	String	optional