Skip to content

jetmiky/rupiahjs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rupiah JS

A simple, lightweight, and performant library to manage Indonesian Rupiah in any JavaScript projcets.

Proud to be Indonesian 🇮🇩

💿 Installation

Using package managers

Install package:

  • yarn add @jetmiky/rupiahjs
  • or npm install --save @jetmiky/rupiahjs

😎 How to use it?

1. Using Rupiah class:

Initializing.

import { Rupiah } from "@jetmiky/rupiahjs";

// Pass an optional number as initial value,
// if it's ommited, will be using "0" as initial value.
const price = new Rupiah(350000);

Access real value

// The outuput of code below is number of "350000"
console.log(price.value);

Mathematic Operation

Currently, supported mathematic operations are addition and subtraction.

// Add numbers as needed. This will return the value after additions.
// In example, method below will be returning 500000.
price.add(50000, 100000);

// Subtract numbers as needed. This will return the value after subtraction.
// In example, method below will be returning 100000.
price.subtract(400000);

Terbilang

Terbilang feature can be used either in class or in separate import. Please scroll below to see the implementation of separate import.

// The outuput of code below is "Seratus Ribu Rupiah"
console.log(price.terbilang);

Currency Formatting

// The available parameters are Prefix and Thousand Separators.
const symbol = "Rp"; // Available options "Rp" | "IDR", default to "Rp"
const separators = "dot"; // Available options "dot" | "comma", default to "dot"

// The output of code below is Rp100.000
console.log(price.getCurrency());
console.log(price.getCurrency(symbol, separators));

2. Only terbilang function:

import { terbilang } from "@jetmiky/rupiahjs";

// The output of code below is "Sepuluh Ribu"
console.log(terbilang(10000));

❓ Questions and Improvements

If you found bugs, having questions, or requesting features, please don't be hesitate to create new issues.

About

Package to managing Indonesian Rupiah

Resources

Stars

Watchers

Forks

Packages

No packages published