freeCodeCamp/curriculum/challenges/english/02-javascript-algorithms-and-data-structures/javascript-algorithms-and-data-structures-projects/roman-numeral-converter.english.md

---
id: a7f4d8f2483413a6ce226cac
title: Roman Numeral Converter
isRequired: true
challengeType: 5
---

## Description
<section id='description'>
Convert the given number into a roman numeral.
All <a href="http://www.mathsisfun.com/roman-numerals.html" target="_blank">roman numerals</a> answers should be provided in upper-case.
Remember to use <a href='http://forum.freecodecamp.org/t/how-to-get-help-when-you-are-stuck/19514' target='_blank'>Read-Search-Ask</a> if you get stuck. Try to pair program. Write your own code.
</section>

## Instructions
<section id='instructions'>

</section>

## Tests
<section id='tests'>

```yml
tests:
  - text: <code>convertToRoman(2)</code> should return "II".
    testString: assert.deepEqual(convertToRoman(2), "II", '<code>convertToRoman(2)</code> should return "II".');
  - text: <code>convertToRoman(3)</code> should return "III".
    testString: assert.deepEqual(convertToRoman(3), "III", '<code>convertToRoman(3)</code> should return "III".');
  - text: <code>convertToRoman(4)</code> should return "IV".
    testString: assert.deepEqual(convertToRoman(4), "IV", '<code>convertToRoman(4)</code> should return "IV".');
  - text: <code>convertToRoman(5)</code> should return "V".
    testString: assert.deepEqual(convertToRoman(5), "V", '<code>convertToRoman(5)</code> should return "V".');
  - text: <code>convertToRoman(9)</code> should return "IX".
    testString: assert.deepEqual(convertToRoman(9), "IX", '<code>convertToRoman(9)</code> should return "IX".');
  - text: <code>convertToRoman(12)</code> should return "XII".
    testString: assert.deepEqual(convertToRoman(12), "XII", '<code>convertToRoman(12)</code> should return "XII".');
  - text: <code>convertToRoman(16)</code> should return "XVI".
    testString: assert.deepEqual(convertToRoman(16), "XVI", '<code>convertToRoman(16)</code> should return "XVI".');
  - text: <code>convertToRoman(29)</code> should return "XXIX".
    testString: assert.deepEqual(convertToRoman(29), "XXIX", '<code>convertToRoman(29)</code> should return "XXIX".');
  - text: <code>convertToRoman(44)</code> should return "XLIV".
    testString: assert.deepEqual(convertToRoman(44), "XLIV", '<code>convertToRoman(44)</code> should return "XLIV".');
  - text: <code>convertToRoman(45)</code> should return "XLV"
    testString: assert.deepEqual(convertToRoman(45), "XLV", '<code>convertToRoman(45)</code> should return "XLV"');
  - text: <code>convertToRoman(68)</code> should return "LXVIII"
    testString: assert.deepEqual(convertToRoman(68), "LXVIII", '<code>convertToRoman(68)</code> should return "LXVIII"');
  - text: <code>convertToRoman(83)</code> should return "LXXXIII"
    testString: assert.deepEqual(convertToRoman(83), "LXXXIII", '<code>convertToRoman(83)</code> should return "LXXXIII"');
  - text: <code>convertToRoman(97)</code> should return "XCVII"
    testString: assert.deepEqual(convertToRoman(97), "XCVII", '<code>convertToRoman(97)</code> should return "XCVII"');
  - text: <code>convertToRoman(99)</code> should return "XCIX"
    testString: assert.deepEqual(convertToRoman(99), "XCIX", '<code>convertToRoman(99)</code> should return "XCIX"');
  - text: <code>convertToRoman(400)</code> should return "CD"
    testString: assert.deepEqual(convertToRoman(400), "CD", '<code>convertToRoman(400)</code> should return "CD"');
  - text: <code>convertToRoman(500)</code> should return "D"
    testString: assert.deepEqual(convertToRoman(500), "D", '<code>convertToRoman(500)</code> should return "D"');
  - text: <code>convertToRoman(501)</code> should return "DI"
    testString: assert.deepEqual(convertToRoman(501), "DI", '<code>convertToRoman(501)</code> should return "DI"');
  - text: <code>convertToRoman(649)</code> should return "DCXLIX"
    testString: assert.deepEqual(convertToRoman(649), "DCXLIX", '<code>convertToRoman(649)</code> should return "DCXLIX"');
  - text: <code>convertToRoman(798)</code> should return "DCCXCVIII"
    testString: assert.deepEqual(convertToRoman(798), "DCCXCVIII", '<code>convertToRoman(798)</code> should return "DCCXCVIII"');
  - text: <code>convertToRoman(891)</code> should return "DCCCXCI"
    testString: assert.deepEqual(convertToRoman(891), "DCCCXCI", '<code>convertToRoman(891)</code> should return "DCCCXCI"');
  - text: <code>convertToRoman(1000)</code> should return "M"
    testString: assert.deepEqual(convertToRoman(1000), "M", '<code>convertToRoman(1000)</code> should return "M"');
  - text: <code>convertToRoman(1004)</code> should return "MIV"
    testString: assert.deepEqual(convertToRoman(1004), "MIV", '<code>convertToRoman(1004)</code> should return "MIV"');
  - text: <code>convertToRoman(1006)</code> should return "MVI"
    testString: assert.deepEqual(convertToRoman(1006), "MVI", '<code>convertToRoman(1006)</code> should return "MVI"');
  - text: <code>convertToRoman(1023)</code> should return "MXXIII"
    testString: assert.deepEqual(convertToRoman(1023), "MXXIII", '<code>convertToRoman(1023)</code> should return "MXXIII"');
  - text: <code>convertToRoman(2014)</code> should return "MMXIV"
    testString: assert.deepEqual(convertToRoman(2014), "MMXIV", '<code>convertToRoman(2014)</code> should return "MMXIV"');
  - text: <code>convertToRoman(3999)</code> should return "MMMCMXCIX"
    testString: assert.deepEqual(convertToRoman(3999), "MMMCMXCIX", '<code>convertToRoman(3999)</code> should return "MMMCMXCIX"');

```

</section>

## Challenge Seed
<section id='challengeSeed'>

<div id='js-seed'>

```js
function convertToRoman(num) {
 return num;
}

convertToRoman(36);
```

</div>



</section>

## Solution
<section id='solution'>


```js
function convertToRoman(num) {
  var ref = [['M', 1000], ['CM', 900], ['D', 500], ['CD', 400], ['C', 100], ['XC', 90], ['L', 50], ['XL', 40], ['X', 10], ['IX', 9], ['V', 5], ['IV', 4], ['I', 1]];
  var res = [];
  ref.forEach(function(p) {
    while (num >= p[1]) {
      res.push(p[0]);
      num -= p[1];
    }
  });
  return res.join('');
}
```

</section>