@deanisy/multi-rubles/readme.md

Стоимость прописью с любыми наименованиями валютных единиц

# multi-rubles.js — стоимость прописью в любых денежных единицах

[![NPM version][npm-image]][npm-url]
[![Build status][travis-image]][travis-url]
[![Test coverage][coveralls-image]][coveralls-url]
[![devDependency status][devdependency-image]][devdependency-url]

В любом документообороте принято писать сумму прописью. Такое должно быть в договорах, актах, расписках и других подобных документах. multi-rubles.js призван решить эту проблему комплексно, он работает в браузере и на серверной стороне.

### На сервере

#### Установить через [npm](//npmjs.org)

```bash
$ npm i --save multi-rubles
```

#### Как использовать

```js
var rubles = require('multi-rubles').rubles;

var text = rubles(12.10, [['рубль', 'рубля', 'рублей'], ['копейка', 'копейки', 'копеек']]);
console.log(text); // двенадцать рублей 10 копеек

var text = rubles(12.10, [['доллар', 'доллара', 'долларов'], ['цент', 'цента', 'центов']]);
console.log(text); // двенадцать долларов 10 центов

var text = rubles("52151,31", [['рубль', 'рубля', 'рублей'], ['копейка', 'копейки', 'копеек']]);
console.log(text); // пятьдесят две тысячи сто пятьдесят один рубль 31 копейка
```

----------------

### В браузере

#### Установить через [bower](http://bower.io)

```bash
$ bower install multi-rubles --save
```

#### Подключить

```html
<script src="bower_components/multi-rubles/lib/rubles.min.js"></script>
```

#### Использовать

```html
<script>
  var rubles = require('multi-rubles').rubles;

  var text = rubles(12.10, [['рубль', 'рубля', 'рублей'], ['копейка', 'копейки', 'копеек']]);
  console.log(text); // двенадцать рублей 10 копеек

  var text = rubles(12.10, [['доллар', 'доллара', 'долларов'], ['цент', 'цента', 'центов']]);
  console.log(text); // двенадцать долларов 10 центов

  var text = rubles("52151,31", [['рубль', 'рубля', 'рублей'], ['копейка', 'копейки', 'копеек']]);
  console.log(text); // пятьдесят две тысячи сто пятьдесят один рубль 31 копейка
</script>
```

----------------

### Нашли ошибку?

Пожалуйста, создайте тикет — https://github.com/meritt/multi-rubles/issues

### Тестирование

Для запуска тестов обновите репозиторий и запустите:

```bash
$ npm test
```

## Автор

* [Алексей Симоненко](mailto:alexey@simonenko.su), [simonenko.su](http://simonenko.su)
* [Шевцов Денис](), [lineapps]()

## Лицензия

Лицензия MIT, смотрите файл `license.md`.

[npm-image]: https://img.shields.io/npm/v/rubles.svg?style=flat
[npm-url]: https://www.npmjs.com/package/multi-rubles
[travis-image]: https://travis-ci.org/meritt/rubles.svg?branch=master
[travis-url]: https://travis-ci.org/meritt/rubles
[coveralls-image]: https://coveralls.io/repos/meritt/rubles/badge.svg?branch=master&service=github
[coveralls-url]: https://coveralls.io/github/meritt/rubles?branch=master
[devdependency-image]: https://img.shields.io/david/dev/meritt/rubles.svg?style=flat
[devdependency-url]: https://david-dm.org/meritt/rubles#info=devDependencies