cn2an: Chinese Numerals To Arabic Numerals

Build Status Pypi MIT License stars API

cn2an 是一个将 中文数字阿拉伯数字 快速转化的工具包!

site 🔗点我访问 DEMO

1 功能

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

  1. 支持 中文数字 => 阿拉伯数字
  2. 支持 大写中文数字 => 阿拉伯数字
  3. 支持 中文数字和阿拉伯数字 => 阿拉伯数字;(开发中)

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

  1. 支持 阿拉伯数字 => 中文数字
  2. 支持 阿拉伯数字 => 大写中文数字
  3. 支持 阿拉伯数字 => 大写人民币
  4. 支持 中文数字和阿拉伯数字 => 中文数字。(开发中)

2 安装

⚠️注意:仅支持 Python 3.6+ 版本。

2.1 使用 pip 安装

pip install cn2an

2.2 从代码库安装

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

3 使用

# 在文件首部引入包
import cn2an

# 查看版本
cn2an.__version__
# output: 0.3.2

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

import cn2an

# 在 strict 模式下,只有严格符合的才可以进行转化
output = cn2an.cn2an("一百二十三", "strict")
# or output = cn2an.cn2an("一二三")
print(output)
# 123

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

# 在 smart 模式下,还可以将混合描述的 1百23 进行转化 (开发中)
output = cn2an.cn2an("1百23", "smart")
print(output)
# 123

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

import cn2an

# 在 low 模式下,数字转化为小写的中文数字
output = cn2an.an2cn("123", "low")
# or output = cn2an.an2cn("123")
print(output)
# 一百二十三

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

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

# 在 smart 模式下,可以将混合描述数字转化为小写的中文数字 (开发中)
utput = cn2an.an2cn("1百23", "smart")
print(output)
# 一百二十三

详细用法见 API.

4 版本支持

  • 理论上支持 WindowsMacOSUbuntu 下的所有 Python 3.6+ 的版本。
  • 实际上仅在 Windows 10MacOS 10.14Ubuntu 16.04Python 3.6.3 上做过完整测试。
  • 欢迎提交其他版本使用情况到 Issues 中,期待你的反馈。
  • 如果你有 Python 2 的使用需求,可 Fork 代码自行修改。当然也欢迎提 PR,贡献自己代码给其他人。

5 问题反馈

  1. 先搜索 Issues 中有没有人已经问过类似的问题;
  2. 如果没有找到解答,请新开一个 issue;
  3. 在「issue 标题」中填写你遇到的问题的简介;
  4. 在「issue 详情」中填写你遇到的问题的详情;
  5. 最后,不要忘记注明你使用的操作系统(比如 Windows 10)和 Python 版本(比如 Python 3.6.3)。

6 计划事项

本项目是用看板管理开发进度,请点击 v0.3 查看开发进度和计划事项。

7 协议

MIT License