Numera 2.1: Laravel Support, 184 Languages, and a Whole Lot More

# Plain PHP
composer require pinoox/numera:^2.1

# Laravel 9 / 10 / 11
composer require pinoox/numera-laravel

use Pinoox\Numera\Laravel\Facades\Numera;

echo Numera::n2w(2024);               // two thousand twenty-four
echo Numera::toCurrency(1500, 'USD'); // one thousand, five hundred dollars

Numera::setLocale('fa');
echo Numera::n2w(1500); // هزار و پانصد

php artisan vendor:publish --tag=numera-config

// config/numera.php
return [
    'default_locale'  => 'en',
    'fallback_locale' => 'en',
];

Numera::init('en-GB')->toCurrency(3.01, 'GBP'); // three pounds and one penny
Numera::init('fa-IR')->getWeekdays();            // starts Saturday
Numera::init('de-AT')->getStrategyName();        // german (inherited from de)

$n = Numera::init('en');

// European format (dot as thousands, comma as decimal)
echo $n->n2w('1.234.567,89');

// Swiss format (apostrophe as thousands)
echo $n->n2w("1'234'567.89");

// Persian/Arabic digits
echo $n->n2w('۱۲۳۴'); // converted to 1234 automatically

// Underscore separator (PHP/Python style)
echo $n->n2w('1_000_000'); // one million

Numera::detectFormat('1.234,56');   // 'european'
Numera::detectFormat("1'000");      // 'swiss'
Numera::detectFormat('۱۲۳');       // 'persian'
Numera::detectFormat('1_000_000'); // 'underscore'

$n = Numera::init('en');

echo $n->toFraction(0.5);   // one half
echo $n->toFraction(0.25);  // one quarter
echo $n->toFraction(0.75);  // three quarters
echo $n->toFraction(1.5);   // one and a half
echo $n->toFraction(2.333); // two and one third

// Persian
echo Numera::init('fa')->toFraction(0.5); // نیم
echo Numera::init('fa')->toFraction(1.5); // یک و نیم

$n = Numera::init('en');

echo $n->toYear(1999); // nineteen ninety-nine
echo $n->toYear(2000); // two thousand
echo $n->toYear(2005); // two thousand and five
echo $n->toYear(2024); // twenty twenty-four

// Persian falls back to standard cardinal
echo Numera::init('fa')->toYear(1402); // هزار و چهارصد و دو

$n = Numera::init('en');

echo $n->toPhone('+1 415 555 0172');
// plus one, four one five, five five five, zero one seven two

echo $n->toPhone('021-8834-1100');
// zero two one, eight eight three four, one one zero zero

// Persian digits work too
echo $n->toPhone('۰۲۱-۸۸۳۴');
// zero two one, eight eight three four

$n = Numera::init('en');

echo $n->toRoman(2024);   // MMXXIV
echo $n->toRoman(1999);   // MCMXCIX
echo $n->fromRoman('XIV'); // 14
echo $n->fromRoman('xl');  // 40 (case-insensitive)

$n = Numera::init('en');

echo $n->toIp('192.168.1.1');
// one ninety-two dot one sixty-eight dot one dot one

echo $n->toVersion('2.14.0');
// two point fourteen point zero

echo $n->toVersion('1.0.0-beta');
// one point zero point zero dash beta

// Cardinals
Numera::init('en')->n2w(4454545156);
// four billion, four hundred fifty-four million, ...

// Ordinals
Numera::init('en')->n2o(21); // twenty-first
Numera::init('fa')->n2o(21); // بیست و یکم

// Currency
Numera::init('en')->toCurrency(1250.50, 'USD');
// one thousand, two hundred fifty dollars and fifty cents

// Units
Numera::init('en')->withUnit(5, 'hour'); // five hours
Numera::init('fa')->withUnit(1, 'day');  // یک روز

// Weekdays
Numera::init('fa')->toWeekday(6); // شنبه

// Cross-locale translation
Numera::init('fa')->translateTo('en', 'دویست و یک'); // two hundred one
Numera::init('en')->translateTo('fa', 'two hundred one'); // دویست و یک

echo Numera::init('fa')->toCurrency(15750000, 'IRR');
// پانزده میلیون و هفتصد و پنجاه هزار ریال

echo Numera::init('en')->toVersion('3.2.1'); // three point two point one

echo Numera::init('en')->n2o(1);         // first
echo Numera::init('en')->toFraction(0.5); // one half

echo Numera::init('en')->toPhone('+44 20 7946 0958');