Terbilang

Masalahnya

Faktur, kuitansi, dan cek di Indonesia mencantumkan jumlah uang dua kali: sekali dalam angka dan sekali dalam huruf, yang disebut terbilang. Setiap sistem akuntansi, penggajian, dan penagihan di Indonesia membutuhkannya, jadi hampir semuanya menulis fungsinya sendiri. Banyak yang keliru, dan kekeliruannya ikut tercetak di kertas.

Ejaannya punya aturan yang tidak seragam. Angka 1 di depan menjadi se- pada sepuluh, seratus, dan seribu, tetapi ejaan baku memakai satu juta, bukan sejuta. Kelompok kosong sering bocor: 1.000.001 dibaca satu juta satu, tidak pernah satu juta nol ribu satu. Lalu angka JavaScript kehilangan ketelitian di atas sekitar 9 kuadriliun. Kode yang memakainya benar sampai triliunan, lalu diam-diam menulis jumlah yang salah di faktur sungguhan.

Yang saya bangun

Library dulu, situs untuk memperagakannya

Saya membangun Terbilang sebagai library yang bisa dipakai software penagihan lain tanpa diubah. Pengguna pertama yang dituju adalah Rinci, proyek slip gaji saya, yang membutuhkannya untuk baris jumlah uang. Library ini tidak tahu apa-apa soal browser dan tidak punya dependensi runtime. Situsnya mengimpor library ini dan tidak menghitung apa pun sendiri. Saya membangun ulang seluruh situs setelah library-nya selesai, dan library-nya tidak berubah sama sekali.

Jumlah besar tetap tepat

Library hanya menerima bilangan bulat yang tersimpan tepat, berupa big integer atau string angka. Angka JavaScript biasa ditolak, tidak dikonversi, karena konversi itulah yang membuat jumlah besar menjadi salah. Serangkaian tes permanen memeriksa nilai di atas batas ketelitian. Satuan terbesar yang didukung adalah kuadriliun (10¹⁵), karena KBBI mencantumkan katanya. Batas itu juga membuat sebagian nilai yang didukung berada di atas batas ketelitian, sehingga tes tersebut tetap bermakna.

Menolak daripada menebak

Enam jenis kesalahan masing-masing mendapat jawaban bertipe yang menyebut persis apa yang gagal: jumlah terlalu besar, angka berkoma, kata yang tidak bisa dibaca, atau opsi yang saling bertentangan. Library tidak pernah mengembalikan tebakan atau hasil setengah jadi. Jumlah yang salah tapi terlihat wajar di faktur lebih buruk daripada tidak ada jumlah sama sekali. Di atas kuadriliun, pemakaiannya dalam bahasa Indonesia belum mapan, jadi library berhenti di situ dan tidak meneruskan polanya.

Huruf bisa dibaca kembali menjadi angka

Kebanyakan alat hanya bekerja satu arah. Terbilang juga membaca huruf kembali menjadi angka, dan arah ini lebih sulit. Dua ratus lima puluh ribu berarti (2×100 + 5×10) × 1.000, bukan 200 + 50.000. Karena ada dua arah, keduanya bisa saya uji satu sama lain.

Setiap angka sampai sejuta diperiksa

Ruang masalahnya terbatas, jadi saya mengujinya secara menyeluruh. Setiap nilai dari 0 sampai 1.000.000 ditulis dalam huruf, diperiksa, dibaca kembali, lalu dibandingkan dengan aslinya. Itu 1.000.001 perjalanan bolak-balik di setiap perubahan, dalam sekitar lima detik, dan build gagal kalau satu saja rusak.

Hasilnya

Library-nya sudah di-build dan siap diterbitkan, mendukung kedua format modul. Situs publiknya tersedia dalam bahasa Indonesia dan Inggris. Saat Anda mengetik, konverter menggambar kurung di atas setiap kelompok tiga angka dengan label juta atau ribu, dan kelompok kosong terlihat menghilang. Mode dokumen mencetak jumlah seperti di kuitansi: # seribu lima ratus rupiah #. Lima opsi, misalnya sejuta, atau milyar dan miliar, masing-masing mengutip pemakaian di balik kedua pilihannya. Halaman perbandingan dengan paket lain dirilis kosong, karena belum ada yang saya ukur. Saya membangunnya dalam waktu kurang dari tujuh jam pada 5 Agustus 2026.