d0004/numbers2words

It spells numbers (and currencies)!

dev-master 2024-06-03 13:49 UTC

Requires

• php: >=7.1

MIT

• D0004

• currency
• numbers
• spell

README

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

Supported languages (ISO 639-1 language codes):

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

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)
• Norwegian krone (NOK)

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