1.0.3 • Published 3 years ago
@develoka/angka-rupiah-js v1.0.3
Angka-rupiah-js
Mengkonversi angka ke dalam format penulisan mata uang rupiah
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