summaryrefslogtreecommitdiffstats
path: root/helpcontent2/source/text/scalc/01/func_roman.xhp
blob: 4600ab3fc6ec4844ff85a9de5495795bab703249 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
-->

<meta>
  <topic id="calcfuncroman" indexer="include" status="PUBLISH">
    <title id="tit" xml-lang="en-US">ROMAN Function</title>
    <filename>/text/scalc/01/func_roman.xhp</filename>
  </topic>
</meta>
<body>
  <section id="func_roman">
    <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_ROEMISCH" localize="false"/>
    <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549">
      <bookmark_value>ROMAN function</bookmark_value>
      <bookmark_value>text functions;convert to roman numbers</bookmark_value>
    </bookmark>
    <h1 id="hd_id881628776094597"><variable id="Roman_h1"><link href="text/scalc/01/func_roman.xhp" name="function ROMAN">ROMAN</link></variable></h1>
    <paragraph id="par_id541542230672101" role="paragraph"><variable id="func_roman_desc"><ahelp hid=".">Converts a number into a Roman numeral. The value range must be between 0 and 3999. A simplification mode can be specified in the range from 0 to 4.</ahelp></variable></paragraph>
  </section>
  <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/>
  <paragraph role="paragraph" id="par_id701542231253817"><input>ROMAN(Number [; Mode])</input></paragraph>
  <paragraph role="paragraph" id="par_id621542232197446"><emph>Number</emph>: the number that is to be converted into a Roman numeral.</paragraph>
  <paragraph role="paragraph" id="par_id621542232197337"><emph>Mode</emph>: optional value ranging between 0 to 4 that indicates the degree of simplification to be used in the conversion. The higher the value, the greater is the simplification of the Roman number.</paragraph>
  <embed href="text/scalc/01/ful_func.xhp#func_head_example"/>
  <paragraph role="paragraph" id="par_id451628776707264"><input>=ROMAN(999)</input> returns "CMXCIX" (uses simplification mode equal to zero, which is the default).</paragraph>
  <paragraph role="paragraph" id="par_id101628778036375"><input>=ROMAN(999;0)</input> returns "CMXCIX".</paragraph>
  <paragraph role="paragraph" id="par_id101628778036134"><input>=ROMAN(999;1)</input> returns "LMVLIV".</paragraph>
  <paragraph role="paragraph" id="par_id101628778036278"><input>=ROMAN(999;2)</input> returns "XMIX".</paragraph>
  <paragraph role="paragraph" id="par_id101628778036364"><input>=ROMAN(999;3)</input> returns "VMIV".</paragraph>
  <paragraph role="paragraph" id="par_id101628778036008"><input>=ROMAN(999;4)</input> returns "IM".</paragraph>
  <paragraph role="paragraph" id="par_id101628778036019"><input>=ROMAN(0)</input> returns "" (empty text).</paragraph>

  <section id="relatedtopics">
    <embed href="text/scalc/01/func_arabic.xhp#Arabic_h1"/>
    <paragraph role="paragraph" id="par_id81634670394769" localize="false"><embedvar href="text/scalc/01/04060110.xhp#head_text"/></paragraph>
  </section>
</body>
</helpdocument>