Angka-rupiah-js

Mengkonversi angka ke dalam format penulisan mata uang rupiah

Demo

Link Demo

Instalasi dan Penggunaan

npm install @develoka/angka-rupiah-js

import toRupiah from '@develoka/angka-rupiah-js';

atau

<script src="https://unpkg.com/@develoka/angka-rupiah-js/index.min.js">

Usage

console.log(toRupiah(50000));
// Output: Rp50.000,00
console.log(toRupiah(50000, {symbol: 'IDR', floatingPoint: 0}));
// Output: 50.000 IDR

Fitur

Mendukung berbagai format penulisan mata uang rupiah, baik formal maupun informal.

Parameter fungsi yang tersedia

|Key|Value|Default|Description| |:--|:-:|:-:|:--| |symbol|string|Rp|Simbol mata uang yang digunakan. Tersedia Rp dan IDR. Gunakan null untuk menghilangkan simbol.| |formal|boolean|true|Menentukan posisi simbol mata uang, di depan atau di belakang nominal menurut kaidah Bahasa Indonesia.| |dot|string|.|Simbol pengganti tanda titik "." pada hasil format| |decimal|string|,|Simbol pengganti tanda koma "," pada hasil format| |floatingPoint|number|2|Menentukan jumlah angka di belakang koma| |replaceZeroDecimals|boolean|false|Opsi untuk menukar bilangan angka di belakang koma yang berisi nol semua dengan ",-"| |useUnit|boolean|false|Opsi untuk memasang satuan unit (rb, jt, M, T) untuk angka ribuan, jutaan, sampai triliun| |k|boolean|false|Opsi untuk mengganti satuan unit ribuan dengan simbol "k"| |longUnit|boolean|false|Memanjangkan singkatan dari satuan unit kembali ke kata asalnya| |spaceBeforeUnit|boolean|false|Memberikan jarak satu spasi antara nominal dan unit|

Contoh penggunaan parameter fungsi

console.log(toRupiah(50000));
// Output: Rp50.000,00
console.log(toRupiah(50000, {symbol: 'IDR'}));
// Output: 50.000,00 IDR
console.log(toRupiah(50000, {formal: false}));
// Output: Rp 50.000,00
console.log(toRupiah(50000, {formal: false, symbol: 'IDR'}));
// Output: IDR 50.000,00
console.log(toRupiah(50000, {dot: ',', floatingPoint: 0}));
// Output: Rp 50,000
console.log(toRupiah(50000, {dot: ',', decimal: '.'}));
// Output: Rp 50,000.00
console.log(toRupiah(50000, {replaceZeroDecimals: true}));
// Output: Rp50.000,-
console.log(toRupiah(50000, {useUnit: true, floatingPoint: 0}));
// Output: Rp50rb
console.log(toRupiah(50000, {symbol: 'IDR', formal: false, useUnit: true, k: true, floatingPoint: 0}));
// Output: IDR 50k
console.log(toRupiah(50000, {symbol: false, useUnit: true, longUnit: true, spaceBeforeUnit: true, floatingPoint: 0}));
// Output: 50 ribu
console.log(toRupiah(50750000000, {useUnit: true, longUnit: true, spaceBeforeUnit: true, formal: false}));
// Output: Rp 50,75 milyar
console.log(toRupiah(5250, {useUnit: true, symbol: null, k: true}));
// Output: 5,25k

Testing

Testing menggunakan jest. Lihat file tests.

npm install
npm run test

Development

Edit index.js kemudian jalankan perintah:

npm run build