Skip to main content

Convert Chinese numerals and Arabic numerals.

Project description

📦 cn2an: Chinese Numerals To Arabic Numerals.

cn2an 是一个将「中文数字」和「阿拉伯数字」互相转化的工具包。

1. 功能

  1. 「中文数字」转「阿拉伯数字」;
  2. 「阿拉伯数字」转「中文数字」;
  3. 「阿拉伯数字」转「大写中文数字」;
  4. 支持命令行调用。

2. 版本支持

  • 理论上支持 python 2.7python 3.6 的所有版本。
  • 实际上仅在 python 2.7.10python 3.6.3 上做过完整测试。
  • 欢迎提交其他版本使用情况到 issues

3. 安装

3.1 使用 pip 安装

pip install cn2an

3.2 从代码库安装

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

4. 使用

4.1 在代码中调用

# 在文件首部引入包
import cn2an

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

1 中文数字转阿拉伯数字

cn2an.cn2an("一百万零五十四")
# output: 1000054

# 支持大写中文数字
cn2an.cn2an("壹佰万零伍十肆")
# output: 1000054

2 阿拉伯数字转中文数字

# 支持数字和字符串两种不同类型的输入
cn2an.an2cn("21024124")
cn2an.an2cn(21024124)
# output: 二千一百零二万四千一百二十四

# 支持小数
cn2an.an2cn("0.414")
cn2an.an2cn(0.414)
# output: 零点四一四

# 支持大写,需要增加额外的参数 True
cn2an.an2cn("21024124", True)
cn2an.an2cn(21024124, True)
# output: 贰仟壹佰零贰万肆仟壹佰贰拾肆

cn2an.an2cn("0.414", True)
cn2an.an2cn(0.414, True)
# output: 零点肆壹肆

4.2 在命令行中使用

1 中文数字转阿拉伯数字

cn2an 一百万零五十四
# output: 1000054

# 支持小数
cn2an 零点四一四
# output: 0.414

# 支持大写
cn2an 壹佰万零伍拾肆
# output: 1000054

2 阿拉伯数字转中文数字

an2cn 21024124
# output: 二千一百零二万四千一百二十四

# 支持小数
an2cn 0.414
# output: 零点四一四

# 支持大写,这里需要增加额外的参数 cap
cn2an 1000054 cap
# output: 壹佰万零伍十肆
an2cn 0.414 cap
# output: 零点肆壹肆

5 TODO

  • 阿拉伯数字转大写中文数字;
  • 关于零的bug;
  • 支持 幺 == 1 的转化;
  • 自动化单元测试。

6 Version

  • v0.0.7 修复 一千五百万零三百零一 等类似格式无法正确转化的问题。
  • v0.1.0 重构代码,兼容 python 2.7。

7 License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cn2an-0.1.2.tar.gz (7.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page