v1.0.4

Usage Guide

RomanNumbersJS — zero dependencies, ready to use.

Installation

npm:

npm install romannumbersjs

CDN (browser):

<script src="https://unpkg.com/romannumbersjs@1.0.4/dist/index.min.js"></script>

Usage

CommonJS (Node.js):

const { convertToRoman, convertToArabic } = require("romannumbersjs");

convertToRoman(2024);    // "MMXXIV"
convertToArabic("XII");  // 12

ES Module:

import { convertToRoman, convertToArabic } from "romannumbersjs";

Browser (after CDN):

// Functions are available in global scope
convertToRoman(999);     // "CMXCIX"
convertToArabic("CMXCIX"); // 999

API

Function	Parameter	Returns
convertToRoman(num)	Number (1-3999)	Roman numeral string, or empty string on invalid input
convertToArabic(str)	Roman numeral string	Arabic number, or -1 on invalid input

Examples

convertToRoman(1);      // "I"
convertToRoman(4);      // "IV"
convertToRoman(9);      // "IX"
convertToRoman(58);     // "LVIII"
convertToRoman(1994);   // "MCMXCIV"
convertToRoman(3999);   // "MMMCMXCIX"

convertToArabic("I");       // 1
convertToArabic("IV");      // 4
convertToArabic("IX");      // 9
convertToArabic("LVIII");   // 58
convertToArabic("MCMXCIV"); // 1994
convertToArabic("MMMCMXCIX"); // 3999