README

php-terbilang adalah sebuah pustaka yang berfungsi untuk mengubah angka menjadi huruf terbilang. php-terbilang ditulis dengan PHP dan dapat menerima masukan angka hingga 108 digit (999+ miliar untrigintiliun). php-terbilang merupakan hasil port / adaptasi dari Python Terbilang.

Instalasi

composer require cyberwolf888/php-terbilang

Penggunaan

require __DIR__ . '/vendor/autoload.php';
use Cyberwolf888\PHPTerbilang\Terbilang;

// Quick conversion with static method
echo Terbilang::convert('1234'); // "seribu dua ratus tiga puluh empat"

// For complex operations or multiple conversions
$t = new Terbilang();
$t->parse('1.000,50');
echo $t->getResult(); // "seribu koma lima nol"

// Chain methods
echo (new Terbilang())->parse('2500')->getResult(); // "dua ribu lima ratus"

php-terbilang dibuat agar memiliki jangkauan yang lebar, tetapi diharapkan dapat membaca angka dengan lebih luwes. Sebagai contoh, "1000 triliun" tidak dibaca sebagai "satu kuadriliun" tetapi "seribu triliun". Sedangkan "1000 juta" tentu akan dibaca sebagai "satu miliar". php-terbilang akan menampilkan tanda koma jika bilangan sudah mencapai triliunan atau lebih untuk meningkatkan keterbacaan:

$t->parse('19000000000000000000071000002011000000');
echo $t->getResult(); # sembilan belas undesiliun, tujuh puluh satu ribu triliun, dua miliar sebelas juta