cr-numeral

Roman Numeral Converter

This is an application that helps convert numbers to Roman numerals or vice versa. Find Roman numerals or Numbers.

const {
  convertNumberToRoman: cnr,
  convertRomanToNumber: crn,
} = require("cr-numeral");
// OR
const cnr = require("cr-numeral").convertNumberToRoman;
const crn = require("cr-numeral").convertRomanToNumber;

const number = 2021;
const numeral = "MMMXXV"; // Case-insensitive

const toRoman = cnr(number);
const toNumber = crn(numeral);

console.log(toRoman, toNumber);

Contact 🚀

Email

• If you are looking to get ahold of me, you can send me an Email : Naphtali Duniya

Social Media

• Instagram : Naphtali Duniya

• Via Twitter : Naphtali Duniya

Telephone

• Call [phone]

Installation

This is a Node.js module available through the npm registry.

Before installing, download and install Node.js.

If this is a brand new project, make sure to create a package.json first with the npm init command.

Installation is done using the npm install command:

$ npm install cr-numeral

Features

• Convert a Number to a Roman Numeral convertNumberToRoman(number)
• Convert a Roman Numeral to a Number convertRomanToNumber("Numeral")

Usage

Browser

// Convert Number to Roman Numeral
String.convertNumberToRoman(2025));
"MMXXV"

// Convert Roman Numeral to Number
// Case-insensitive
String.convertRomanToNumber("MMXXI"));
"2021"

NodeJS

Converting a Number to Roman Numeral

> const { convertNumberToRoman } = require('cr-numeral');
// OR
> const convertNumberToRoman = require('cr-numeral').convertNumberToRoman;

> convertNumberToRoman(2021));
"MMXXI"

> convertNumberToRoman(-2021)); // Can not convert a negative number or zero
"Can not convert Zero or negative numbers!!!"

> convertNumberToRoman("na256m"));
"You must provide only valid numbers!!!"

> convertNumberToRoman(false));
"Cannot use Boolean values!!!"

> convertNumberToRoman(true));
"Cannot use Boolean values!!!"

Converting Roman Numeral to a Number

> const { convertRomanToNumber } = require('cr-numeral');
// OR
> const convertRomanToNumber = require('cr-numeral').convertRomanToNumber;

> convertRomanToNumber("MMXXI"));
"2021"

> convertRomanToNumber("na256m"));
"Provide a valid roman character!!!"
"Cause these are invalid roman numerals : [ N,A,2,5,6 ]"

> convertRomanToNumber(6355));
"You must provide only valid strings!!!"

> convertRomanToNumber(false));
"Cannot use Boolean values!!!"

> convertRomanToNumber(true));
"Cannot use Boolean values!!!"

Changelog

Tests

To run the test suite, first install the dependencies, then run npm test:

$ npm install
$ npm test

Donate

I maintain this project in my free time, if it helped you please support my work via blockchain or Coinbase - 1C7QofCMbDm7XfzaxWGVvQ91DrjPQqzTQx , thanks a lot!

License

Copyright (c) 2021 Duniya Naphtali Licensed under the MIT license.