1.0.3 • Published 3 years ago

@develoka/angka-rupiah-js v1.0.3

Weekly downloads
32
License
MIT
Repository
github
Last release
3 years ago

Angka-rupiah-js NPM Version Minified Size

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

KeyValueDefaultDescription
symbolstringRpSimbol mata uang yang digunakan. Tersedia Rp dan IDR. Gunakan null untuk menghilangkan simbol.
formalbooleantrueMenentukan posisi simbol mata uang, di depan atau di belakang nominal menurut kaidah Bahasa Indonesia.
dotstring.Simbol pengganti tanda titik "." pada hasil format
decimalstring,Simbol pengganti tanda koma "," pada hasil format
floatingPointnumber2Menentukan jumlah angka di belakang koma
replaceZeroDecimalsbooleanfalseOpsi untuk menukar bilangan angka di belakang koma yang berisi nol semua dengan ",-"
useUnitbooleanfalseOpsi untuk memasang satuan unit (rb, jt, M, T) untuk angka ribuan, jutaan, sampai triliun
kbooleanfalseOpsi untuk mengganti satuan unit ribuan dengan simbol "k"
longUnitbooleanfalseMemanjangkan singkatan dari satuan unit kembali ke kata asalnya
spaceBeforeUnitbooleanfalseMemberikan 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