工作中经常遇到阿拉伯数字转换称为中文数字或者大写金额,在网上搜了下,cn2an口碑较好,遂进行了一番学习。
安装
pip install cn2an
依赖库为setuptools、PyYAML
查看版本
In [1]: import cn2an In [2]: cn2an.__version__ Out[2]: '0.5.8'
查看模块定义的标识符
In [3]: dir(cn2an) Out[3]: ['An2Cn', 'Cn2An', 'Transform', '__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', '__version__', 'an2cn', 'cn2an', 'transform', 'utils']
模块结构
cn2an模块结构如下:
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文件可知,模块主要对外暴露cn2an、an2cn和transform三个方法。
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. 中文数字转阿拉伯数字
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方法有两个参数:inputs和mode,inputs类型为字符串,默认值为空值,mode类型为字符串,默认值为strict,查看源码可知,mode仅支持strict, normal, smart等三个值。
返回值为int类型。
最大支持到10**16,即 千万亿,最小支持到 10**-16。
1.1 严格模式(strict)
默认为严格模式,严格模式下只有严格符合数字拼写的才可以进行转化。
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 # 检查输入数据是否有效 ---> 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"不符合格式的数据:{integer_data}") 158 elif mode == "normal": 159 # 纯数模式:一二三 ValueError: 不符合格式的数据:一二三
1.2 正常模式(normal)
在正常模式下,可以对 一二三 进行转化
In [5]: output = cn2an.cn2an("一二三",'normal') In [6]: output Out[6]: 123
1.3 灵活模式(smart)
在 灵活模式下,可以对混合拼写的 1百23 进行转换,也可以对口语化数字进行转换
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. 阿拉伯数字转中文数字
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 阿拉伯数字转中文数字 :param inputs: 阿拉伯数字 :param mode: 小写数字,大写数字,人民币大写,直接转化 :return: 中文数字
查看帮助可知:
an2cn方法有两个参数:inputs和mode,inputs类型可以是字符串、整数或者浮点数,默认值为空值,mode类型为字符串,默认值为low,查看源码可知,mode支持low, up, rmb, direct等四个值。
返回值为str类型。
2.1 小写中文模式(low)
在 low 模式(默认)下,数字转化为小写的中文数字。
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 模式下,数字转化为大写的中文数字。
In [7]: output = cn2an.an2cn("123", "up") In [8]: output Out[8]: '壹佰贰拾叁'
2.3 人民币模式(rmb)
在 rmb 模式下,数字转化为人民币专用的描述。
In [9]: output = cn2an.an2cn("123", "rmb") In [10]: output Out[10]: '壹佰贰拾叁元整'
2.4 直接模式(direct)
在 direct 模式下,阿拉伯数字直接转换为对应的中文小写数字,小数点转换为汉字点。
In [11]: output = cn2an.an2cn("-1.23", "direct") In [12]: output Out[12]: '负一点二三'
3. 句子中的数字转换
文档中说明该功能为实验性质,功能尚不稳定。
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方法具有两个参数:inputs和method,inputs的类型为字符串,method的类型为字符串,默认值为cn2an,查看源码可知method支持cn2an和an2cn这两个值。返回值为字符串。
3.1 中文数字转阿拉伯数字
在 cn2an 方法(默认)下,可以将句子中的中文数字转换为阿拉伯数字
查看源码可知默认情况下,中文数字转换阿拉伯数字采用的smart模式。
In [3]: output = cn2an.transform("小王捡了一百块钱") In [4]: output Out[4]: '小王捡了100块钱' In [5]: output = cn2an.transform("整齐的步伐,一二一") In [6]: output Out[6]: '整齐的步伐,121'
transform方法会根据正则表达式,检测日期、摄氏度、分数、百分比等特殊情况进行转换。
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("任务已经完成百分之五十", "cn2an") In [12]: output Out[12]: '任务已经完成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 阿拉伯数字转中文数字
在an2cn 方法下,可以将句子中的阿拉伯数字转换为中文数字。
an2cn 模式下,依然会检测日期、摄氏度、分数、百分比等特殊情况进行转换
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("任务完成了50%", "an2cn") In [11]: output Out[11]: '任务完成了百分之五十' In [12]: output = cn2an.transform("今天最低气温1摄氏度", "an2cn") In [13]: output Out[13]: '今天最低气温一摄氏度'
3.3 问题(大写数字)
根据源码可知transform方法优先考虑日期、分数、百分比、摄氏度等情况判断,不符合这几种情况的都判断为普通数字,因此,大写数字在transform方法中表现并不好!
In [14]: output = cn2an.transform("金额为壹万贰仟元", "cn2an") WARN: 不符合格式的数据:万 WARN: 不符合格式的数据:仟 In [15]: output Out[15]: '金额为壹万贰仟元 '
测试
cn2an提供了web demo进行体验。https://www.dovolopor.com/cn2an
API
cn2an提供了API,支持Java、Javascript、Go、Julia、Python等。
https://github.com/Ailln/cn2an/wiki/API#http-api
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
更新日志
- 群星《狐妖小红娘月红篇 电视剧原声带》[320K/MP3][233.61MB]
- 英雄联盟s14四强淘汰赛规则是什么 全球总决赛四强淘汰赛规则详解
- 英雄联盟s14四强赛怎么分组 S14全球总决赛四强赛分组规则详解
- 英雄联盟s14四强赛抽签规则是什么 S14全球总决赛四强抽签规则详解
- ButterQuartet-ScintillaEarlyItalianStringQuartets(DeLuxe)(2024)[24Bit-WAV]
- 草原最美情歌《迷醉女中音》2CD/DTS-ES[WAV]
- 爵士女伶何芸妮《靡靡之音》(香港版)[WAVCUE]
- 游戏中辱骂他人同样侵犯名誉权 一玩家被判道歉
- 老游戏远程共享申请失败 美国版权局拒绝豁免请愿
- 通过本地化支付解决方案,解锁150亿美元拉美和非洲游戏市场
- 群星《狐妖小红娘月红篇 电视剧原声带》[FLAC/分轨][574.68MB]
- 群星《红色冲浪板 电影配乐专辑》[320K/MP3][106.63MB]
- 罗艺恒《What Could've Been》[320K/MP3][50.62MB]
- 于台烟.1989-人间山水【银河唱片】【WAV+CUE】
- 杨克强.1992-特制的面具【恩华声视】【WAV+CUE】