cn2an 0.4.4

Convert Chinese numerals and Arabic numerals.

cn2an: Chinese Numerals To Arabic Numerals

📦 cn2an 是一个快速转化 中文数字 和 阿拉伯数字 的工具包！

🔗点我访问 DEMO

🎈 en2an: 「英文数字」和「阿拉伯数字」互转正在收集需求中！ 详情

1 功能

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

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

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

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

1.3 句子转化（试验性功能）

• 支持 中文数字 => 阿拉伯数字；
• 支持 阿拉伯数字 => 中文数字；

1.4 其他

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

2 安装

⚠️注意：

1. 本地安装仅支持 Python 的 3.6 以上版本；
2. 其他语言用户可以考虑使用 HTTP API ；
3. 请尽可能使用 cn2an 的最新版本。

2.1 使用 pip 安装

pip install cn2an -U

2.2 从代码库安装

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

3 使用

# 在文件首部引入包
import cn2an

# 查看版本
print(cn2an.__version__)
# 0.4.4

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("负一百二十三")
# output:
# -123

# 以上三种模式均支持小数
output = cn2an.cn2an("一点二三")
# 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")
# output:
# 负一百二十三

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

3.3 句子转化（试验性功能）

import cn2an

output = cn2an.transform("我捡了一百块钱")
# 或者
output = cn2an.transform("我捡了一百块钱", "cn2an")
# output:
# 我捡了100块钱

output = cn2an.transform("我捡了100块钱", "an2cn")
# output:
# 我捡了一百块钱

详细用法见 API.

3.4 HTTP API

主要为其他语言用户提供方便，当然 Python 用户也可以使用。

Java

import java.net.URL;
import java.net.HttpURLConnection;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class HttpGetExample {
    public static void main(String[] args) throws Exception {
        HttpGetExample http = new HttpGetExample();

        String url = "https://api.dovolopor.com/v1/cn2an";
        String params = "?text=123&function=an2cn&method=low";
        http.get(url + params);
    }

    private void get(String url) throws Exception {
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();

        con.setRequestMethod("GET");
        con.setRequestProperty("User-Agent", "Mozilla/5.0");

        BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();

        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();

        System.out.println(response.toString());
    }
}
// { output: "一百二十三", msg: "转化成功" }

Javascript

const axios = require("axios")

axios.get("https://api.dovolopor.com/v1/cn2an", {
  params: {
    text: "123",
    function: "an2cn",
    method: "low"
  }
}).then(
  function (res) {
    console.log(res.data);
  }
)
// { output: "一百二十三", msg: "转化成功" }

Go

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main(){
    params := url.Values{}
    Url, err := url.Parse("https://api.dovolopor.com/v1/cn2an")
    if err != nil {
        return
    }
    params.Set("text", "123")
    params.Set("function", "an2cn")
    params.Set("method", "low")

    Url.RawQuery = params.Encode()
    urlPath := Url.String()
    resp,err := http.Get(urlPath)
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
// { output: "一百二十三", msg: "转化成功" }

Python

import requests

response = requests.get("https://api.dovolopor.com/v1/cn2an",
  params={
    "text": "1234567890",
    "function": "an2cn",
    "method": "low"
  }
)
print(response.json())
# { output: "一百二十三", msg: "转化成功" }

4 版本支持

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

5 问题反馈

1. 先搜索 Issues 中有没有人已经问过类似的问题；
2. 如果没有找到解答，请新开一个 issue：
   1. 首先，在「issue 标题」中填写你遇到的问题的简介；
   2. 然后，在「issue 详情」中填写你遇到的问题的详情；
   3. 最后，不要忘记注明你使用的操作系统（比如 Windows 10）和 Python 版本（比如 Python 3.6.3）。
3. 还可以参考 Issue Template 。

6 开发相关

6.1 开发进度

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

6.2 代码测试

本地测试使用 Anaconda 的虚拟环境，测试方法如下。

# 执行测试
bash scripts/local_test.sh

线上测试使用 GitHub Actions 。

6.3 性能测试

• 测试版本：v0.4.4

• 测试设备：2.3 GHz 双核Intel Core i5 MacBook Pro

• 测试代码：performance.py

• 测试方法：

  pip install -r requirements_test.txt
  
  python -m cn2an.performance
  

• 测试结果：

  序号	功能	执行次数	执行时间(平均)	性能(次/秒)
  1	an2cn	10000	0.20	50k
  2	cn2an	10000	0.35	29k

测试时，我使用的是最大长度的测试数据！因此，大多数情况下该库的性能会更好～

7 许可证

8 交流

欢迎添加微信号：Ailln_，备注「cn2an」，我邀请你进入交流群。

9 致谢

• Thunder Bouble: 提出很多有效的反馈，包括一些 bug 和新功能；
• Damon Yu: 增加对全角数字和全角符号的支持。

10 参考

• 🎈 cn2an 核心代码解析
• 如何发布自己的包到 pypi
• Python 中的小陷阱
• 汉字数字转阿拉伯数字