japanese-numerals-to-number

convert Japanese Numerals into number

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
japanese-numerals-to-number
1.0.27 years ago7 years agoMinified + gzip package size for japanese-numerals-to-number in KB

Readme

japanese-numerals-to-number
Converts Japanese Numerals into number.
!Build Statustravis-imagetravis-url !NPM versionnpm-imagenpm-url !Code Stylestyle-imagestyle-url !Licenselicense-imagelicense-url

USAGE

const ja2num = require('japanese-numerals-to-number');
const assert = require('assert');

assert(ja2num('〇') === 0);
assert(ja2num('一億二千三百四十五万六千七百八十九') === 123456789);

assert(ja2num('二千十七') === 2017);
assert(ja2num('二〇一七') === 2017); // supports positional notation

assert.throws(() => ja2num(null), TypeError);
assert.throws(() => ja2num('二十三十'), Error);
assert.throws(() => ja2num('億千万'), Error);

assert(ja2num('壱百壱拾') === 110); // supports formal numerals (daiji) used in legal documents
assert.throws(() => ja2num('一百一十'), Error);

API

var convertedNum = ja2num(stringOfJapaneseNumerals);

  • Supports Japanese Numerals between 0 (that is '〇') and Number.MAXSAFEINTEGER (9007199254740991, that is '九千七兆千九百九十二億五千四百七十四万九百九十一'). Any number larger than Number.MAX_SAFE_INTEGER is not guaranteed.
  • Throws TypeError when argument is not a string.
  • Throws Error when argument is an invalid Japanese Numerals.

supported characters

numbers 0 to 9

- , , , , , , , , ,

names of powers of 10

- , , , , ,

formal numerals (daiji) used in legal documents

- , , ,

INSTALL

$ npm install japanese-numerals-to-number

AUTHOR

LICENSE

Licensed under the MIT license.