dimaskiddo / angka-terbilang-nodejs

NodeJS package for Converting Decimal to an Indonesian Wording format

NodeJS package for Converting Decimal to an Indonesian Wording format

This package will help you to convert a decimal to an Indonesian wording format, for example 123 will be converted to seratus dua puluh tiga. This package was inspired from develoka/angka-terbilang-js by Develoka Team.

Getting Started

These instructions will get you this package can be used in your project.

Prerequisites

Prequisites Packages:

• NodeJS (NodeJS Programming Language)

Using This Package

Below is the instructions to use this package:

• Install this package to your project

npm install --save @dimaskiddo/angka-terbilang-nodejs

• Import this package to your code

...
const angka = require('@dimaskiddo/angka-terbilang-nodejs')
...

• Use ToTerbilang function to convert your decimal string

...
console.log(angka.toTerbilang('123'))
...

Example Usage of Package

Below is the simple example source code:

const angka = require('@dimaskiddo/angka-terbilang-nodejs')
console.log(angka.toTerbilang('123'))

Example Usage for in Browser Javascript

Below is the example of using for in Browser Javascript:

<script src="https://unpkg.com/@dimaskiddo/angka-terbilang-nodejs@latest/index.min.js"></script>
console.log(angka.toTerbilang('123'))

Development

Editing

• Clone this repository in to your local computer

git clone -b master https://github.com/dimaskiddo/angka-terbilang-nodejs.git

• Edit index.js file in the root of cloned repository directory

Running The Tests

To run the test you can run the following command

npm run test

Rebuilding

After editing you also need to rebuild the minified and browser javascript version by running the following command

npm run minified

Or you can run the full build with the test with following command

npm run build

Benchmarking

Benchmark is done with four (4) other packages that has the same function. It's done by converting a decimal number with units hundreds of thousands, hundreds of millions, hundreds of billions, hundreds of trillions.

Benchmark tools are provided by Develoka Team

Benchmark Results

Benchmark with NodeJS 10.18.0 @ November 8th 2020 14:55

Package	Angka Ratusan Ribu	Angka Ratusan Juta	Angka Ratusan Milyar	Angka Ratusan Triliun
@dimaskiddo/angka-terbilang-nodejs	2,836,662 ops/sec	2,029,144 ops/sec	1,386,470 ops/sec	1,095,911 ops/sec
@develoka/angka-terbilang-js	2,385,251 ops/sec	1,832,777 ops/sec	1,371,450 ops/sec	1,085,423 ops/sec
dikyarga/angka-menjadi-terbilang	113,920 ops/sec	97,849 ops/sec	85,656 ops/sec	75,029 ops/sec
BosNaufal/terbilang-js	194,925 ops/sec	133,416 ops/sec	76,289 ops/sec	47,955 ops/sec
rimara14/terbilang	532,279 ops/sec	312,694 ops/sec	188,072 ops/sec	2,504,031 ops/sec

Benchmark Device

Operating System: MacOS High Sierra 10.13.6
CPU Model: Intel(R) Core(TM) i5-5250U CPU @ 1.60GHz
CPU Core: 2 Core with Hypterthreading (4 vCPU)
RAM: 8 GB
Disk Type: SSD

Benchmark Notes

The result might be different depending on the undelying software or hardware that used to run benchmark

Built With

• NodeJS - NodeJS Programming Languange

Authors

• Dimas Restu Hidayanto - Initial Work - DimasKiddo
• R. M. Dwi Rizki - Fungsional Test and Benchmarking - rmdwirizki

See also the list of contributors who participated in this project