japanese-numerals-to-number

japanese-numerals-to-number

Converts Japanese Numerals into number.

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.MAX_SAFE_INTEGER (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

• Takuto Wada

LICENSE

Licensed under the MIT license.

Changelog

1.0.2 (2017-05-18)

Bug Fixes

• throw Error when 十,百,千 appears more than once in subsequence (055d8daa, closes #1)