Python使用cn2an實(shí)現(xiàn)中文數(shù)字與阿拉伯?dāng)?shù)字的相互轉(zhuǎn)換

更新時(shí)間：2021年03月02日 10:20:30 作者：mighty13

這篇文章主要介紹了Python使用cn2an實(shí)現(xiàn)中文數(shù)字與阿拉伯?dāng)?shù)字的相互轉(zhuǎn)換，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

工作中經(jīng)常遇到阿拉伯?dāng)?shù)字轉(zhuǎn)換稱為中文數(shù)字或者大寫金額，在網(wǎng)上搜了下，cn2an口碑較好，遂進(jìn)行了一番學(xué)習(xí)。

安裝

pip install cn2an

依賴庫為setuptools、PyYAML

查看版本

In [1]: import cn2an
In [2]: cn2an.__version__
Out[2]: '0.5.8'

查看模塊定義的標(biāo)識(shí)符

In [3]: dir(cn2an)
Out[3]:
['An2Cn',
 'Cn2An',
 'Transform',
 '__all__',
 '__builtins__',
 '__cached__',
 '__doc__',
 '__file__',
 '__loader__',
 '__name__',
 '__package__',
 '__path__',
 '__spec__',
 '__version__',
 'an2cn',
 'cn2an',
 'transform',
 'utils']

模塊結(jié)構(gòu)

cn2an模塊結(jié)構(gòu)如下：

an2cn.py
an2cn_test.py
cn2an.py
cn2an_test.py
config.yaml
performance.py
transform.py
transform_test.py
utils.py
__init__.py

查看模塊下的__init__.py文件可知，模塊主要對(duì)外暴露cn2an、an2cn和transform三個(gè)方法。

from .cn2an import Cn2An
from .an2cn import An2Cn
from .transform import Transform

__version__ = "0.5.8"

cn2an = Cn2An().cn2an
an2cn = An2Cn().an2cn
transform = Transform().transform

__all__ = [
  "__version__",
  "cn2an",
  "an2cn",
  "transform"
]

使用說明

1. 中文數(shù)字轉(zhuǎn)阿拉伯?dāng)?shù)字

In [4]: help(cn2an.cn2an)
Help on method cn2an in module cn2an.cn2an:

cn2an(inputs: str = None, mode: str = 'strict') -> int method of cn2an.cn2an.Cn2An instance

查看幫助可知:
cn2an方法有兩個(gè)參數(shù)：inputs和mode，inputs類型為字符串，默認(rèn)值為空值，mode類型為字符串，默認(rèn)值為strict，查看源碼可知，mode僅支持strict, normal, smart等三個(gè)值。
返回值為int類型。
最大支持到10**16，即千萬億，最小支持到 10**-16。

1.1 嚴(yán)格模式（strict）

默認(rèn)為嚴(yán)格模式，嚴(yán)格模式下只有嚴(yán)格符合數(shù)字拼寫的才可以進(jìn)行轉(zhuǎn)化。

In [1]: import cn2an
In [2]: output = cn2an.cn2an("一百二十三")
In [3]: output
Out[3]: 123
In [4]: output = cn2an.cn2an("一二三")
---------------------------------------------------------------------------
ValueError                Traceback (most recent call last)
<ipython-input-4-4c55ae4aa4a9> in <module>
----> 1 output = cn2an.cn2an("一二三")

c:\users\administrator\appdata\local\programs\python\python37\lib\site-packages\cn2an\cn2an.py in cn2an(self, inputs, mode)
   30
   31       # 檢查輸入數(shù)據(jù)是否有效
---> 32       sign, integer_data, decimal_data, is_all_num = self.__check_input_data_is_valid(inputs, mode)
   33
   34       # smart 下的特殊情況

c:\users\administrator\appdata\local\programs\python\python37\lib\site-packages\cn2an\cn2an.py in __check_input_data_is_valid(self, check_data, mode)
  155     else:
  156       if mode == "strict":
--> 157         raise ValueError(f"不符合格式的數(shù)據(jù)：{integer_data}")
  158       elif mode == "normal":
  159         # 純數(shù)模式：一二三

ValueError: 不符合格式的數(shù)據(jù)：一二三

1.2 正常模式（normal）

在正常模式下，可以對(duì) 一二三進(jìn)行轉(zhuǎn)化

In [5]: output = cn2an.cn2an("一二三",'normal')
In [6]: output
Out[6]: 123

1.3 靈活模式（smart）

在靈活模式下，可以對(duì)混合拼寫的 1百23 進(jìn)行轉(zhuǎn)換，也可以對(duì)口語化數(shù)字進(jìn)行轉(zhuǎn)換

In [7]: output = cn2an.cn2an("1百23", "smart")
In [8]: output
Out[8]: 123
In [9]: output = cn2an.cn2an("一萬二", "smart")
In [10]: output
Out[10]: 12000

2. 阿拉伯?dāng)?shù)字轉(zhuǎn)中文數(shù)字

In [1]: import cn2an

In [2]: help(cn2an.an2cn)
Help on method an2cn in module cn2an.an2cn:

an2cn(inputs: Union[str, int, float] = None, mode: str = 'low') -> str method of cn2an.an2cn.An2Cn instance
  阿拉伯?dāng)?shù)字轉(zhuǎn)中文數(shù)字
  :param inputs: 阿拉伯?dāng)?shù)字
  :param mode: 小寫數(shù)字，大寫數(shù)字，人民幣大寫，直接轉(zhuǎn)化
  :return: 中文數(shù)字

查看幫助可知:

an2cn方法有兩個(gè)參數(shù)：inputs和mode，inputs類型可以是字符串、整數(shù)或者浮點(diǎn)數(shù)，默認(rèn)值為空值，mode類型為字符串，默認(rèn)值為low，查看源碼可知，mode支持low, up, rmb, direct等四個(gè)值。
返回值為str類型。

2.1 小寫中文模式（low）

在 low 模式（默認(rèn)）下，數(shù)字轉(zhuǎn)化為小寫的中文數(shù)字。

In [3]: output = cn2an.an2cn("123")
In [4]: output
Out[4]: '一百二十三'
In [5]: output = cn2an.an2cn("123", "low")
In [6]: output
Out[6]: '一百二十三'

2.2 大寫中文模式（up）

在 up 模式下，數(shù)字轉(zhuǎn)化為大寫的中文數(shù)字。

In [7]: output = cn2an.an2cn("123", "up")
In [8]: output
Out[8]: '壹佰貳拾叁'

2.3 人民幣模式（rmb）

在 rmb 模式下，數(shù)字轉(zhuǎn)化為人民幣專用的描述。

In [9]: output = cn2an.an2cn("123", "rmb")
In [10]: output
Out[10]: '壹佰貳拾叁元整'

2.4 直接模式（direct）

在 direct 模式下，阿拉伯?dāng)?shù)字直接轉(zhuǎn)換為對(duì)應(yīng)的中文小寫數(shù)字，小數(shù)點(diǎn)轉(zhuǎn)換為漢字點(diǎn)。

In [11]: output = cn2an.an2cn("-1.23", "direct")
In [12]: output
Out[12]: '負(fù)一點(diǎn)二三'

3. 句子中的數(shù)字轉(zhuǎn)換

文檔中說明該功能為實(shí)驗(yàn)性質(zhì)，功能尚不穩(wěn)定。

In [1]: import cn2an

In [2]: help(cn2an.transform)
Help on method transform in module cn2an.transform:

transform(inputs: str, method: str = 'cn2an') -> str method of cn2an.transform.Transform instance

transform方法具有兩個(gè)參數(shù)：inputs和method，inputs的類型為字符串，method的類型為字符串，默認(rèn)值為cn2an，查看源碼可知method支持cn2an和an2cn這兩個(gè)值。返回值為字符串。

3.1 中文數(shù)字轉(zhuǎn)阿拉伯?dāng)?shù)字

在 cn2an 方法（默認(rèn)）下，可以將句子中的中文數(shù)字轉(zhuǎn)換為阿拉伯?dāng)?shù)字
查看源碼可知默認(rèn)情況下，中文數(shù)字轉(zhuǎn)換阿拉伯?dāng)?shù)字采用的smart模式。

In [3]: output = cn2an.transform("小王撿了一百塊錢")
In [4]: output
Out[4]: '小王撿了100塊錢'
In [5]: output = cn2an.transform("整齊的步伐，一二一")
In [6]: output
Out[6]: '整齊的步伐，121'

transform方法會(huì)根據(jù)正則表達(dá)式，檢測(cè)日期、攝氏度、分?jǐn)?shù)、百分比等特殊情況進(jìn)行轉(zhuǎn)換。

In [7]: output = cn2an.transform("小王的生日是二零零一年三月四日", "cn2an")
In [8]: output
Out[8]: '小王的生日是2001年3月4日'
In [9]: output = cn2an.transform("拋出去的硬幣為正面的概率是二分之一", "cn2an")
In [10]: output
Out[10]: '拋出去的硬幣為正面的概率是1/2'
In [11]: output = cn2an.transform("任務(wù)已經(jīng)完成百分之五十", "cn2an")
In [12]: output
Out[12]: '任務(wù)已經(jīng)完成50%'
In [13]: output = cn2an.transform("明天最低溫度一度", "cn2an")
In [14]: output
Out[14]: '明天最低溫度1度'
In [15]: output = cn2an.transform("明天最低溫度一攝氏度", "cn2an")
In [16]: output
Out[16]: '明天最低溫度1℃'

3.2 阿拉伯?dāng)?shù)字轉(zhuǎn)中文數(shù)字

在an2cn 方法下，可以將句子中的阿拉伯?dāng)?shù)字轉(zhuǎn)換為中文數(shù)字。
an2cn 模式下，依然會(huì)檢測(cè)日期、攝氏度、分?jǐn)?shù)、百分比等特殊情況進(jìn)行轉(zhuǎn)換

In [2]: output = cn2an.transform("小王撿了100塊錢", "an2cn")
In [3]: output
Out[3]: '小王撿了一百塊錢'
In [4]: output = cn2an.transform("金額為12000元 ", "an2cn")
In [5]: output
Out[5]: '金額為一萬二千元 '
In [6]: output = cn2an.transform("小王的生日是2001年3月4日", "an2cn")
In [7]: output
Out[7]: '小王的生日是二零零一年三月四日'
In [8]: output = cn2an.transform("拋出去的硬幣為正面的概率是1/2", "an2cn")
In [9]: output
Out[9]: '拋出去的硬幣為正面的概率是二分之一'
In [10]: output = cn2an.transform("任務(wù)完成了50%", "an2cn")
In [11]: output
Out[11]: '任務(wù)完成了百分之五十'
In [12]: output = cn2an.transform("今天最低氣溫1攝氏度", "an2cn")
In [13]: output
Out[13]: '今天最低氣溫一攝氏度'

3.3 問題（大寫數(shù)字）

根據(jù)源碼可知transform方法優(yōu)先考慮日期、分?jǐn)?shù)、百分比、攝氏度等情況判斷，不符合這幾種情況的都判斷為普通數(shù)字，因此，大寫數(shù)字在transform方法中表現(xiàn)并不好！

In [14]: output = cn2an.transform("金額為壹萬貳仟元", "cn2an")
WARN: 不符合格式的數(shù)據(jù)：萬
WARN: 不符合格式的數(shù)據(jù)：仟
In [15]: output
Out[15]: '金額為壹萬貳仟元 '

測(cè)試

cn2an提供了web demo進(jìn)行體驗(yàn)。https://www.dovolopor.com/cn2an

API

cn2an提供了API，支持Java、Javascript、Go、Julia、Python等。
https://github.com/Ailln/cn2an/wiki/API#http-api

到此這篇關(guān)于Python使用cn2an實(shí)現(xiàn)中文數(shù)字與阿拉伯?dāng)?shù)字的相互轉(zhuǎn)換的文章就介紹到這了,更多相關(guān)Python 中文數(shù)字與阿拉伯?dāng)?shù)字轉(zhuǎn)換內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: