Template:Roman/doc: Difference between revisions

Jump to navigation Jump to search
m (→‎top: +{{Lua sidebar}})
 
m (1 revision imported)
 
(No difference)

Latest revision as of 21:02, 26 January 2020

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/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
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}} 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

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

TemplateData for Roman

Convert numbers to Roman numerals.

Template parameters

ParameterDescriptionTypeStatus
Number1

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
Numberoptional
Message2

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
Stringoptional

See also