Not Providing Milkshakes

    number-to-cyrillic

    2.7.0 • Public • Published

    NPM

    Convert number to English, Russian or Ukrainian

    npm version

    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

    Install

    npm i number-to-cyrillic

    DownloadsWeekly Downloads

    91

    Version

    2.7.0

    License

    MIT

    Unpacked Size

    104 kB

    Total Files

    9

    Last publish

    Collaborators

    • staslgvin23
    • vshashkov