Template:Roman/doc

From WikiAlpha
Jump to: navigation, search
The below content is licensed according to Creative Commons Attribution-ShareAlike License contrary to the public domain logo at the foot of the page. It originally appeared on http://en.wikipedia.org. The original article might still be accessible here. You may be able to find a list of the article's previous contributors on the talk page.

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

Template:Pre

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/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}}
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}} MMMMCMXCIX
5000 {{Roman|5000}} Template:Overline
5001 {{Roman|5001}} Template:OverlineI
69105 {{Roman|69105}} Template:OverlineMMMMCV
1048576 {{Roman|1048576}} Template:OverlineMMMDLXXVI
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

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}} MMMCCCXXXVII
1-0.9861 {{Roman|1-0.9861|fraction=yes}}
4.6*2.5 {{Roman|4.6*2.5|fraction=yes}} XI
1/3 {{Roman|1/3|fraction=yes}}
9999/10000 {{Roman|9999/10000|fraction=yes}}
100+5.5 {{Roman|100+5.5|fraction=yes}} V

TemplateData

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

Template:Math templates