Skip to content

v5.0.0

Latest

Choose a tag to compare

@rmunate rmunate released this 18 Nov 20:21

SpellNumber for Laravel

CI and GitHub Pages
Packagist

SpellNumber 5.0.0 uses PHP Intl to spell out numbers, money amounts, and ordinals. It includes formatting defaults for 11 languages, configurable currency labels and output replacements, and Laravel macros.

Installation

  • Laravel 8–13 and a PHP version supported by your Laravel release.
  • PHP 8.0 or later with intl and mbstring enabled. Laravel 13 requires PHP 8.3 or later.
composer require rmunate/spell-number:^5.0

Laravel discovers the service provider automatically. Publishing the configuration is optional.

Usage

use Rmunate\Utilities\SpellNumber;

SpellNumber::value(100)->locale('en')->toLetters();
// one hundred

SpellNumber::float('1.01')->locale('es')->currency('pesos')->fraction('centavos')->toMoney();
// un peso con un centavo

SpellNumber::integer(2)->locale('es')->toOrdinal(SpellNumber::ORDINAL_FEMALE);
// segunda

For exact decimals, pass a string with a dot and no grouping separators. Output is lowercase by default; ICU versions can differ in their spellings and available ordinal rules.

Documentation · Laravel quickstart · API reference · Upgrade to 5.0.0

Contributing

Run composer test for the PHP suite. See the contribution guide for docs builds, CI, and release steps.

Thanks to Ashok Devatwal, Olsza, Siros Fakhri, Jens Twesmann, Gabriel Rausch, Alejandro Diaz, Frank Sepulveda, Ngô Quốc Đạt, and everyone who has contributed.

Released under the MIT License.