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 nggit/php-terbilang

Penggunaan

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

$t = new Terbilang();

$t->parse('1.000,00');
echo $t->getResult(); # seribu koma nol nol

$t->parse('1001');
echo $t->getResult(); # seribu satu

$t->parse('121001');
echo $t->getResult(); # seratus dua puluh satu ribu satu

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