veob/rubles

rubles.js — стоимость прописью (форк)

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

Данный форк позволяет указание своих наименований (валюты) вместо стандартных рубля и копейки. Как это сделать описано ниже.

На сервере

Установить через npm

$ npm install rubles

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

var rubles = require('rubles').rubles;

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

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

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

{rubles} = require 'rubles'

text = rubles 1000.32
console.log text # одна тысяча рублей 32 копейки

text = rubles "2000000,1"
console.log text # два миллиона рублей 10 копеек

Использование кастомных наименований (или валюты отличной от рублёвой)

Для использования своих наименований вам нужно передать три формы использования слова с числами 1, 2 и 5 соотвественно. Наименования можно передавать как для целой части числа, так и для дробной. Рассмотрим это на примере слова "штука":

Форма с числом 1 — одна штука
С числом 2 — две штуки
С числом 5 — пять штук

Также можно передать род наименовая для целой части числа (мужской — masculine, женский — feminime. В данном случае род — женский.

var rubles = require('rubles').rubles;
var options = {
  intDenom: ['штука', 'штуки', 'штук'],
  intDenomGender: 'feminime',
  decDenom: ['штучка', 'штучки', 'штучек']
};
var text = rubles(12.10, options);
console.log(text); // двенадцать штук 10 штучек

var text = rubles("1,01");
console.log(text); // одна штука 01 штучка

В браузере

Установить через bower

$ bower install rubles --save

Подключить

<script src="components/rubles/lib/rubles.min.js"></script>

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

<script>
var text = rubles(12.10);
console.log(text); // двенадцать рублей 10 копеек

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

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

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

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

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

$ npm test

Автор

Алексей Симоненко, simonenko.su

Лицензия

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

veob / rubles