axdraft/number-to-cyrillic

Convert number to words | English, Ukrainian, and Russian

Convert number to English, Russian or Ukrainian

Converts number to words (UAH, RUB, USD, EUR and without currency). This library supports English, Ukrainian and Russian languages.

Install

npm install number-to-cyrillic

yarn add number-to-cyrillic

Demo

You can try this library here.

API

.convert(number[, options])

Converts an integer into an object witch contain value and the currency name. Optionally you can decide whether to display output with currency or not, to display a capital letter for the value by adding an object with some propertis. For example:

var numberToString = require('number-to-cyrillic');

numberToString.convert(21);
// {
//    convertedInteger: 'двадцять одна',
//    integerCurrency: 'гривня',
//    convertedFractional: 'нуль',
//    fractionalCurrency: 'копійок',
//    integer: 21,
//    fractional: 0,
//    shortName: 'грн.'
// }

numberToString.convert(34, {
  currency: 'usd'
});
// {
//    convertedInteger: 'тридцять чотири',
//    integerCurrency: 'долари США',
//    convertedFractional: 'нуль',
//    fractionalCurrency: 'центів',
//    integer: 34,
//    fractional: 0,
//    shortName: 'долара США'
// }

numberToString.convert(76.21, {
  capitalize: true
});
// {
//    convertedInteger: 'Сімдесят шість',
//    integerCurrency: 'гривень',
//    convertedFractional: 'двадцять одна',
//    fractionalCurrency: 'копійка',
//    integer: 76,
//    fractional: 21,
//    shortName: 'грн.'
// }

numberToString.convert(76.26, {
  language: 'en'
});
// {
//    convertedInteger: 'seventy-six',
//    integerCurrency: 'hryvnias',
//    convertedFractional: 'twenty-six',
//    fractionalCurrency: 'cents',
//    integer: 76,
//    fractional: 26,
//    shortName: 'UAH'
// }

See detailed description of all available options below:

Option	Default Value	Description
capitalize	false	By setting a value for this option to true you might make the first letter in uppercase
currency	'uah'	By setting a value to this option to 'usd' or 'eur' or 'rub' or false you'll get the output for selected currency name or without currency.
language	'ua'	By setting a value to this option to 'en' or 'ru' you'll get the output for selected language.
customDecimalNameCasesForEnglish	false	By setting a value for this option to true you will change default decimal name cases for UAH and RUB in English translation to kopek, kopeks.
customCurrencyPrefixForEnglish	none	By setting a value for this option to a string you will change the default currency in English translation. E.g. without prefix: dollars, with - US dollars