chinese number converter

chinese-number-convertor

This is a simple Chinese number converter that converts between Chinese numbers and Arabic numbers.

? Quickstart

 from cnc import convert

print ( convert . chinese2number ( "五十七" )) #57
print ( convert . number2chinese ( 57 )) #五十七

chinese2number(string) -> (float|int)

Returns the arabic number representation of given string.

Notes

The function uses a loosely-matching logic, so the given string doesn't need to be condensed to a specific pattern.

 print ( convert . chinese2number ( "兩千零一十二" )) #2012
print ( convert . chinese2number ( "二零一二" )) #will also be 2012
print ( convert . chinese2number ( "2012" )) #will be, of course, 2012

That being said, please still avoid ambiguous and grammartically incorrect string such as一兆一or一百一千億.

Support character

Support following characters:

• Normal number : One...Nine, Ten, Hundred, Thousand
• Large number till 10 ⁵² -1: Ten thousand, ten thousand... Extreme
• Zero : Zero, ．
• Capital version of all characters above: 1...9, Shi, Bai, Qian
• Arabic number : 1...9, 0
• Simplified version off all characters above: 2, Wan...

Arabic numbers were also supported because they will sometimes be mixed with characters, like "150 million".

number2chinese(int) -> (string)

Returns the chinese representation of given number.

Arguments

• language : string, " T " or " S ".
  • Choose between Traditional and Simplified characters.
  • (default is "T")
• bigNumber : bool, True or False .
  • Output capital version of charaters.
  • (default is False)

 print ( convert . number2chinese ( 202 )) #兩百零二
print ( convert . number2chinese ( 202 , language = "S" , bigNumber = True )) #贰佰零贰

• forceErLian : string, " auto ", " force " or " force Not ".
  • Whether to distinguish Er(two) and Lian(two).
    1. When set to "auto", the output will follow regional convention.
    2. When set to "force", both Traditional and Simplified version will distinguish word usage.
    3. When set to "forceNot", it will always output Er(2) for number "two".
  • (default is "auto")

This will only effect when not using capital number (bigNumber = False). Using capital number will always output 2/2.

 print ( convert . number2chinese ( 202 , language = "T" )) #兩百零二
print ( convert . number2chinese ( 202 , language = "T" , forceErLian = "forceNot" )) #二百零二
print ( convert . number2chinese ( 202 , language = "S" )) #二百零二
print ( convert . number2chinese ( 202 , language = "S" , forceErLian = "force" )) #两百零二

Notes

This function uses "Wanjin" logic when dealing with larger number (>10 ⁸ ), which basically means that every 4 digits will be treated as a group.

This is the most common logic to deal with large numbers, and can support up to 10 ⁵² -1.