rikosage/number-wordify

Simple formatter for converting numbers to a string

1.1 2019-02-13 11:52 UTC

This package is auto-updated.

Last update: 2024-04-06 06:43:24 UTC


README

Build Status Code Intelligence Status Scrutinizer Code Quality

NumberWordify

Расширяемая библиотека для перевода числа из цифр в слова прописью. Время от времени используется в различных документах. Предполагается использовать для работы с валютами, или любыми другими единицами измерений, где требуется сумма прописью.

Пул-реквесты принимаются, рекомендуется расширять класс rikosage\NumberWordify\WordifyFacade, а так же классы новых единиц измерения (килограммы, метры, градусы), если требуется.

Посмотреть онлайн

Установка

Установка производится через composer:

composer require rikosage/number-wordify

Либо необходимо добавить библиотеку в require-секцию файла composer.json:

"require": {
    "rikosage/number-wordify": "*",
  },

Примеры использования

Без использования единиц измерения (десятичная часть не учитывается)

use rikosage\NumberWordify\Formatter as Wordify;

$wordify = new Wordify();
echo $wordify->asWords(832654); 
//восемьсот тридцать две тысячи шестьсот пятьдесят четыре

Использование валют

use rikosage\NumberWordify\Formatter as Wordify;
use rikosage\NumberWordify\Unit\Currency\Rouble;

$wordify = new Wordify(new Rouble());
echo $wordify->asWords(911443.31);
//девятьсот одиннадцать тысяч четыреста сорок три рубля тридцать одна копейка

Использование фасада

use rikosage\NumberWordify\WordifyFacade;

echo WordifyFacade::toDocumentInRoubles(12110.54);
//двенадцать тысяч сто десять рублей 54 коп.