python cn2an模块和en2an模块（阿拉伯数字与中英文互转）

资源地址： github.com/Ailln/cn2an github.com/Ailln/en2an

1 功能

1.1 `中文数字` => `阿拉伯数字`

支持 中文数字 => 阿拉伯数字；
支持 大写中文数字 => 阿拉伯数字；
支持 中文数字和阿拉伯数字 => 阿拉伯数字；

1.2 `阿拉伯数字` => `中文数字`

支持 阿拉伯数字 => 中文数字；
支持 阿拉伯数字 => 大写中文数字；
支持 阿拉伯数字 => 大写人民币；

1.3 句子转化

支持 中文数字 => 阿拉伯数字；
- 支持 日期；
- 支持 分数；
- 支持 百分比；
- 支持 摄氏度；
支持 阿拉伯数字 => 中文数字；
- 支持 日期；
- 支持 分数；
- 支持 百分比；
- 支持 摄氏度；

1.4 其他

支持 小数；
支持 负数；
支持 HTTP API。

2 安装

⚠️ 注意：

本地安装仅支持 Python 的 3.6 以上版本；

其他语言用户可以考虑使用 HTTP API ；

尽可能使用 cn2an 的最新版本。

2.1 使用 pip 安装

pip install cn2an -U

2.2 从代码库安装

git clone https://github.com/Ailln/cn2an.git
cd cn2an && python setup.py install

2.3 常见问题

2.3.1 关于 PyYAML

问题：安装 PyYAML 时出现错误，ERROR: Cannot uninstall 'PyYAML'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.

解决方法：先手动更新 PyYAML 到最新版本，再安装 cn2an。

pip install PyYAML -U --ignore-installed

3 使用

# 在文件首部引入包
import cn2an

# 查看当前版本号
print(cn2an.__version__)
# 0.5.11

3.1 `中文数字` => `阿拉伯数字`

最大支持到 10**16，即 千万亿，最小支持到 10**-16。

import cn2an

# 在 strict 模式（默认）下，只有严格符合数字拼写的才可以进行转化
output = cn2an.cn2an("一百二十三")
# 或者
output = cn2an.cn2an("一百二十三", "strict")
# output:
# 123

# 在 normal 模式下，可以将 一二三 进行转化
output = cn2an.cn2an("一二三", "normal")
# output:
# 123

# 在 smart 模式下，可以将混合拼写的 1百23 进行转化
output = cn2an.cn2an("1百23", "smart")
# output:
# 123

# 以上三种模式均支持负数
output = cn2an.cn2an("负一百二十三", "strict")
# output:
# -123

# 以上三种模式均支持小数
output = cn2an.cn2an("一点二三", "strict")
# output:
# 1.23

3.2 `阿拉伯数字` => `中文数字`

最大支持到10**16，即千万亿，最小支持到 10**-16。

import cn2an

# 在 low 模式（默认）下，数字转化为小写的中文数字
output = cn2an.an2cn("123")
# 或者
output = cn2an.an2cn("123", "low")
# output:
# 一百二十三

# 在 up 模式下，数字转化为大写的中文数字
output = cn2an.an2cn("123", "up")
# output:
# 壹佰贰拾叁

# 在 rmb 模式下，数字转化为人民币专用的描述
output = cn2an.an2cn("123", "rmb")
# output:
# 壹佰贰拾叁元整

# 以上三种模式均支持负数
output = cn2an.an2cn("-123", "low")
# output:
# 负一百二十三

# 以上三种模式均支持小数
output = cn2an.an2cn("1.23", "low")
# output:
# 一点二三

3.3 句子转化

⚠️：试验性功能，可能会造成不符合期望的转化。

import cn2an

# 在 cn2an 方法（默认）下，可以将句子中的中文数字转成阿拉伯数字
output = cn2an.transform("小王捡了一百块钱")
# 或者
output = cn2an.transform("小王捡了一百块钱", "cn2an")
# output:
# 小王捡了100块钱

# 在 an2cn 方法下，可以将句子中的中文数字转成阿拉伯数字
output = cn2an.transform("小王捡了100块钱", "an2cn")
# output:
# 小王捡了一百块钱


## 支持日期
output = cn2an.transform("小王的生日是二零零一年三月四日", "cn2an")
# output:
# 小王的生日是2001年3月4日

output = cn2an.transform("小王的生日是2001年3月4日", "an2cn")
# output:
# 小王的生日是二零零一年三月四日

## 支持分数
output = cn2an.transform("抛出去的硬币为正面的概率是二分之一", "cn2an")
# output:
# 抛出去的硬币为正面的概率是1/2

output = cn2an.transform("抛出去的硬币为正面的概率是1/2", "an2cn")
# output:
# 抛出去的硬币为正面的概率是二分之一

## 支持百分比
## 支持摄氏度