Cara Memformat Angka dan Uang di JavaScript untuk Pemula

Angka 1250000 di halaman web terlihat seperti data mentah. Dengan Intl.NumberFormat, kamu bisa menampilkannya sebagai Rp1.250.000 sesuai format Indonesia tanpa menulis fungsi manual.

Laptop menampilkan kode JavaScript untuk memformat angka dan uang

Kamu punya data harga dari API berupa angka 1250000, lalu menampilkannya apa adanya di halaman web. Pembaca harus menghitung sendiri berapa juta angka itu. JavaScript punya Intl.NumberFormat yang menyelesaikan masalah ini dalam beberapa baris kode, lengkap dengan pemisah ribuan dan simbol mata uang sesuai locale Indonesia.

Mengapa Angka Perlu Diformat

Angka mentah dari database atau API tidak dirancang untuk dibaca manusia. 1250000 dan 0.75 terlihat sama di semua negara, padahal pembaca di Indonesia terbiasa melihat titik sebagai pemisah ribuan dan koma sebagai pemisah desimal. Di Amerika Serikat kebalikannya: koma untuk ribuan, titik untuk desimal.

Kalau kamu memformat sendiri dengan mengganti karakter, hasilnya rawan salah untuk nilai desimal atau angka negatif. Intl.NumberFormat sudah menangani aturan tersebut berdasarkan standar locale, jadi kamu tidak perlu menulis logika penggantian karakter manual.

Dasar Intl.NumberFormat dengan Locale Indonesia

Pemakaian paling sederhana cukup memberi kode locale id-ID ke konstruktornya, lalu memanggil format() dengan angka yang ingin ditampilkan.

const angka = 1250000;
const formatter = new Intl.NumberFormat('id-ID');

console.log(formatter.format(angka));
// 1.250.000

Pemisah ribuan yang muncul adalah titik, sesuai kebiasaan penulisan angka di Indonesia. Kalau kamu butuh format desimal, tambahkan opsi minimumFractionDigits dan maximumFractionDigits.

const desimal = new Intl.NumberFormat('id-ID', {
  minimumFractionDigits: 2,
  maximumFractionDigits: 2
});

console.log(desimal.format(0.75));
// 0,75

Nilai desimal tetap dua digit meskipun angka aslinya hanya satu digit di belakang koma. Opsi ini berguna untuk menampilkan nilai tukar, diskon, atau rasio.

Menampilkan Harga dalam Rupiah

Untuk mata uang, tambahkan style: 'currency' dan kode mata uang IDR. Hasilnya langsung memuat simbol Rp di depan angka.

const rupiah = new Intl.NumberFormat('id-ID', {
  style: 'currency',
  currency: 'IDR',
  minimumFractionDigits: 0
});

console.log(rupiah.format(1250000));
// Rp1.250.000

Setelan minimumFractionDigits: 0 membuat harga bulat tidak menampilkan ,00 di belakangnya. Untuk harga barang ritel yang umumnya bulat, tampilan ini lebih bersih. Kalau kamu menampilkan nilai transaksi keuangan yang butuh presisi sen, biarkan dua digit desimal tetap muncul.

Simpan objek Intl.NumberFormat di luar fungsi render kalau dipakai berulang. Membuat formatter baru untuk setiap baris tabel bisa memperlambat halaman ketika data yang ditampilkan berjumlah ratusan. Pola ini mirip dengan cara kamu menyimpan referensi elemen DOM saat memperbarui tabel dinamis seperti pada tabel sortir otomatis dengan JavaScript.

Format Persen dan Satuan Lain

style: 'percent' berguna saat menampilkan diskon atau progres. Masukkan nilai desimal, bukan angka persen yang sudah dikali 100.

const persen = new Intl.NumberFormat('id-ID', {
  style: 'percent',
  maximumFractionDigits: 1
});

console.log(persen.format(0.125));
// 12,5%

Jangan mengirim 12.5 ke formatter persen karena hasilnya akan menjadi 1.250%. Untuk satuan seperti byte atau gram, gunakan style: 'unit' dengan properti unit yang sesuai.

Tips agar Format Angka Tidak Berantakan

  • Simpan angka sebagai tipe number di JavaScript, bukan string. Format dilakukan saat menampilkan, bukan saat menyimpan.
  • Tentukan satu helper format di awal file, misalnya formatRupiah, lalu panggil di semua tempat yang butuh tampilan serupa.
  • Gunakan maximumFractionDigits untuk membatasi desimal panjang hasil pembagian, misalnya rata-rata nilai.
  • Perhatikan nilai null atau undefined sebelum memformat. Keduanya perlu dicek dulu agar tidak memunculkan teks aneh di tabel.

Kalau data yang diformat berasal dari array hasil pengolahan, kamu bisa memakai map untuk mengubah setiap angka sekaligus. Teknik pengolahan array semacam ini dibahas lebih lengkap di 7 metode array JavaScript untuk mengolah data sehari-hari.

Kapan Cukup Pakai toFixed

toFixed sering dipakai pemula untuk membulatkan desimal. Metode ini mengembalikan string dengan jumlah digit tertentu, tetapi tidak menambahkan pemisah ribuan dan tidak mengikuti locale. Untuk menampilkan angka pendek seperti skor atau rating, toFixed cukup. Begitu berurusan dengan harga, total belanja, atau laporan keuangan, Intl.NumberFormat lebih tepat karena pembaca langsung mengenali formatnya.

Angka yang sama bisa terlihat benar di satu negara dan membingungkan di negara lain. Format tampilan mengikuti kebiasaan pembaca, bukan sekadar matematika.

Ringkasan

Gunakan Intl.NumberFormat dengan locale id-ID untuk pemisah ribuan dan desimal ala Indonesia. Tambahkan style: 'currency' bila ingin simbol Rp muncul otomatis. Simpan formatter di luar loop render, dan pastikan data berupa number sebelum diformat. Harga dan angka statistik di halamanmu langsung terbaca tanpa perlu dihitung manual.

Pertanyaan yang Sering Diajukan

Apakah Intl.NumberFormat didukung semua browser modern?

Ya, fitur ini sudah tersedia di browser modern. Untuk kebutuhan produksi, cek dokumentasi kompatibilitas karena opsi seperti style: 'unit' dan beberapa locale mungkin berperilaku berbeda di browser lama.

Bagaimana cara menampilkan angka tanpa simbol Rp?

Jangan pakai opsi currency. Cukup berikan locale id-ID tanpa style, lalu atur minimumFractionDigits dan maximumFractionDigits sesuai kebutuhan. Hasilnya hanya pemisah ribuan dan desimal.

Bisakah format ini dipakai untuk input form?

Bisa untuk tampilan, tetapi hati-hati saat nilainya dikirim kembali ke server. String hasil format memuat titik dan koma yang bukan bagian dari angka. Simpan nilai asli di atribut data atau variabel terpisah, lalu format hanya untuk ditampilkan.