Skip to content

Latest commit

 

History

History
96 lines (75 loc) · 3.47 KB

README.md

File metadata and controls

96 lines (75 loc) · 3.47 KB
Raw

Angka-rupiah-js NPM Version Minified Size NPM Downloads

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