Template:Roman/doc

From Omniversalis

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[edit]

{{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[edit]

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/6
  • • = 1/12
  • Є = 1/24
  • ƧƧ = 1/36
  • Ɔ = 1/48
  • Ƨ = 1/72
  • Ƨ = 1/144
  • ℈ = 1/288
  • » = 1/1728
  • N = 0

Examples[edit]

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
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.

Examples:

  • {{Roman}}:
  • {{Roman|}}:

Decimal, fractional, and arithmetic examples[edit]

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

TemplateData[edit]

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly error report for this template.

TemplateData for Roman

<templatedata> { "params": { "1": { "type": "number", "label": "Number", "example": "69105", "description": "The number to be converted to Roman numerals. If the parameter passed cannot be interpreted as a numerical value, no output is generated." }, "2": { "default": "N/A", "label": "Message", "example": "Too big", "description": "Message to display for numbers that are too big to be displayed in Roman numerals. (The largest number supported is 4999999.)", "type": "string" } }, "description": "Convert numbers to Roman numerals." } </templatedata>

See also[edit]