jurchiks/numbers2words

It spells numbers (and currencies)!

2.9.0 2022-03-14 13:16 UTC

README

This is a general-purpose library meant for number spelling for use in, e.g. legal documents and bills.

License Downloads

Supported languages (ISO 639-1 language codes):

  • English (en)
  • Estonian (et)
  • Latvian (lv)
  • Lithuanian (lt)
  • Russian (ru)
  • Spanish (es)
  • Italian (it)
  • Polish (pl)

Supported currencies (ISO 4217 currency codes):

  • British Pounds (GBP)
  • Euro (EUR)
  • Latvian Lats (LVL)
  • Lithuanian Lits (LTL)
  • Russian Roubles (RUR)
  • U.S. Dollars (USD)
  • Polish Zloty (PLN)
  • Tanzanian Shillings (TZS)

Installation:

composer require jurchiks/numbers2words

Usage:

use js\tools\numbers2words\Speller;

Speller::spellNumber(123, Speller::LANGUAGE_RUSSIAN);
// output: сто двадцать три
Speller::spellCurrency(123, Speller::LANGUAGE_ENGLISH, Speller::CURRENCY_EURO, false);
// output: one hundred twenty three euro
Speller::spellCurrency(123, Speller::LANGUAGE_ENGLISH, Speller::CURRENCY_EURO);
// output: one hundred twenty three euro and 0 cents
Speller::spellCurrency(123.45, Speller::LANGUAGE_ENGLISH, Speller::CURRENCY_EURO, true, true);
// output: one hundred twenty three euro and forty five cents
Speller::spellCurrencyShort(123.45, Speller::LANGUAGE_ENGLISH, Speller::CURRENCY_EURO);
// output: one hundred twenty three EUR 45/100

Twig:

There is a Twig extension available for this library: jurchiks/numbers2words_twig