dkin-om / romanice

A JavaScript library for converting to/from Roman numerals.

romanice - Convert to/from Roman numerals

A JavaScript library for converting to/from Roman numerals, e.g., 3888↔MMMDCCCLXXXVIII, 38888↔ↂↂↂↁↀↀↀⅮⅭⅭⅭⅬⅩⅩⅩⅤⅠⅠⅠ

Install

npm install romanice

Import

CommonJS

const Romanice = require('romanice');

ES6

import * as Romanice from 'romanice';

Browser

<script src="https://cdn.jsdelivr.net/npm/romanice/dist/romanice.min.js"></script>

Usage

Standard - I, V, X, L, C, D, M

const { romanice } = Romanice;
const standardConverter = romanice();

const roman = standardConverter.toRoman(3888);
// roman === 'MMMDCCCLXXXVIII'

const decimal = standardConverter.fromRoman('MMMCMXCIX');
// decimal === 3999

Unicode - Ⅰ, Ⅴ, Ⅹ, Ⅼ, Ⅽ, Ⅾ, ↀ, ↁ, ↂ

const { romanice, symbols } = Romanice;
const unicodeConverter = romanice(symbols.UNICODE);

const roman = unicodeConverter.toRoman(38888);
// roman === 'ↂↂↂↁↀↀↀⅮⅭⅭⅭⅬⅩⅩⅩⅤⅠⅠⅠ'

const decimal = unicodeConverter.fromRoman('ↂↂↂↀↂⅭↀⅩⅭⅠⅩ');
// decimal === 39999

Syntax

romanice([symbols])

symbols - Array of Roman numeral symbols representing the character set. If omitted, assumes the standard symbols ['I', 'V', 'X', 'L', 'C', 'D', 'M'].

License

MIT