chinese-numbers-converter

chinese-numbers-converter.js

Small library that converts Chinese numbers into arabic Number, such as 兩百四十五 into 245.

Language support

Supports Traditional, Simplified, Financial numbers and some dialects. Only integers are supported, except the limited support for Arabic decimal + Chinese number, like "3.5萬". The largest supported character is 億/亿.

Usage examples

The ChineseNumber class contains these methods:

• toInteger() - converts a Chinese or mixed number into Arabic and returns a JavaScript Number type.
• toArabicString() - translates the entire string (possibly with multiple numbers in it) and returns the same string, but with Arabic numbers.
• isNumberOrSpace() - checks whether the character is part of a number (true) or unrelated text (false).

new ChineseNumber('兩百四十五').toInteger(); // 245 - Normal number
new ChineseNumber('345 萬').toInteger(); // 3,450,000 - Mixed Arabic and Chinese
new ChineseNumber('3.5萬').toInteger(); // 35,000 - The only supported type of decimals
new ChineseNumber(' 二〇一二年').toInteger(); // 2012 - Phone, year etc: without the words "thousand, hundred, ten"
new ChineseNumber('卅六').toInteger(); // 36 - Cantonese slang
new ChineseNumber('***貳佰零伍元***').toInteger(); // 205 - finance numbers 
new ChineseNumber('1000 and one').toInteger(); // 1000 - ignore non-Chinese words

Possible unexpected results

new ChineseNumber(' 二百 or 兩百').toInteger(); // 400 - do not try to parse multiple numbers at once

Availability

• Standalone JS class - chinese-numbers.js
• NPM package - chinese-numbers-converter

License and contributing

Unlicense / Public domain. You can do everything.

Pull requests and bug reports are welcome.