Skip to main content

Convert Chinese numerals and Arabic numerals.

Project description

📦 cn2an: Chinese Numerals To Arabic Numerals

Build Status Pypi MIT License stars API

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

🔗点我访问 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

8 交流

欢迎添加微信号:kinggreenhall,备注「cn2an」,我邀请你进入交流群。

9 致谢

  • Thunder Bouble: 提出很多有效的反馈,包括一些 bug 和新功能。

10 参考

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.3.2.tar.gz (83.6 kB view details)

Uploaded Source

File details

Details for the file cn2an-0.3.2.tar.gz.

File metadata

  • Download URL: cn2an-0.3.2.tar.gz
  • Upload date:
  • Size: 83.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.32.1 CPython/3.6.4

File hashes

Hashes for cn2an-0.3.2.tar.gz
Algorithm Hash digest
SHA256 f2f863e64c828efc4a0ab0a32cd322970d44340baf0c6e7e3d5f2b05db549e0d
MD5 bafd824c61f0be7648279fd9d55d584f
BLAKE2b-256 f654f1fdc5238cab9d2cc1631ae0f5fbee766f0c7bfc83726448e620a9174e8d

See more details on using hashes here.

Supported by

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