num2words库 - 将数字转换为多种语言的文字

.. image:: https://img.shields.io/pypi/v/num2words.svg :target: https://pypi.python.org/pypi/num2words

.. image:: https://travis-ci.org/savoirfairelinux/num2words.svg?branch=master :target: https://travis-ci.org/savoirfairelinux/num2words

.. image:: https://coveralls.io/repos/github/savoirfairelinux/num2words/badge.svg?branch=master :target: https://coveralls.io/github/savoirfairelinux/num2words?branch=master

num2words是一个将数字如42转换为文字如forty-two的库。它支持多种语言（完整语言列表见下文），甚至可以生成序数词如forty-second（尽管目前这个功能对某些语言来说还有些bug）。

该项目托管在GitHub_上。欢迎贡献。

.. _GitHub: https://github.com/savoirfairelinux/num2words

安装

安装num2words最简单的方法是使用pip::

pip install num2words

或者，你可以下载源码包，然后执行::

python setup.py install

这个库的测试套件是新的，所以还比较简单，但可以通过以下命令运行::

python setup.py test

要运行完整的CI测试套件（包括代码检查和多个Python环境）::

pip install tox
tox

使用方法

命令行::

$ num2words 10001
ten thousand and one
$ num2words 24,120.10
twenty-four thousand, one hundred and twenty point one
$ num2words 24,120.10 -l es
veinticuatro mil ciento veinte punto uno
$num2words 2.14 -l es --to currency
dos euros con catorce céntimos

在代码中只需使用一个函数::

>>> from num2words import num2words
>>> num2words(42)
forty-two
>>> num2words(42, to='ordinal')
forty-second
>>> num2words(42, lang='fr')
quarante-deux

除了数字参数外，还有两个主要的可选参数，to:和lang:

to: 要使用的转换器。支持的值有：

cardinal (默认)
ordinal
ordinal_num
year
currency

lang: 要将数字转换成的语言。支持的值有：

en (英语，默认)
am (阿姆哈拉语)
ar (阿拉伯语)
az (阿塞拜疆语)
by (白俄罗斯语)
ce (车臣语)
cy (威尔士语)
cz (捷克语)
de (德语)
dk (丹麦语)
en_GB (英语 - 英国)
en_IN (英语 - 印度)
en_NG (英语 - 尼日利亚)
es (西班牙语)
es_CO (西班牙语 - 哥伦比亚)
es_CR (西班牙语 - 哥斯达黎加)
es_VE (西班牙语 - 委内瑞拉)
es_GT (西班牙语 - 危地马拉)
eu (欧元)
fa (波斯语)
fi (芬兰语)
fr (法语)
fr_CH (法语 - 瑞士)
fr_BE (法语 - 比利时)
fr_DZ (法语 - 阿尔及利亚)
he (希伯来语)
hu (匈牙利语)
id (印度尼西亚语)
is (冰岛语)
it (意大利语)
ja (日语)
kn (卡纳达语)
ko (韩语)
kz (哈萨克语)
lt (立陶宛语)
lv (拉脱维亚语)
no (挪威语)
pl (波兰语)
pt (葡萄牙语)
pt_BR (葡萄牙语 - 巴西)
sl (斯洛文尼亚语)
sr (塞尔维亚语)
sv (瑞典语)
ro (罗马尼亚语)
ru (俄语)
te (泰卢固语)
tg (塔吉克语)
tr (土耳其语)
th (泰语)
vi (越南语)
nl (荷兰语)
uk (乌克兰语)

你可以提供类似fr_FR的值；如果国家不存在但语言存在，代码会回退到基本语言（即fr）。如果你提供了不支持的语言，会引发NotImplementedError。因此，如果你想用回退方式调用num2words，你可以这样做::

try:
    return num2words(42, lang=mylang)
except NotImplementedError:
    return num2words(42, lang='en')

此外，一些转换器和语言支持其他可选参数，这些参数在实际使用中是必要的。

Wiki

有关一些本地化的额外信息，请查看Wiki_。欢迎提出改进Wiki的建议。

.. _Wiki: https://github.com/savoirfairelinux/num2words/wiki

历史

num2words基于一个旧库pynum2word，由Taro Ogawa在2003年创建。不幸的是，该库停止维护，作者也无法联系到。另一位开发者Marius Grigaitis在2011年添加了立陶宛语支持，但没有接管项目的维护工作。

因此，我基于Marius Grigaitis的改进，将pynum2word重新发布为num2words。

Virgil Dupras, Savoir-faire Linux