A tool to convert numbers (int, float) into Persian words
Project description
num2fawords
This package provides functions to convert a number (int or float) to a Persian word form.
installation
Python 3.3+ is required.
Install using pip install num2fawords command.
Usage
>>> from num2fawords import words, ordinal_words
>>> words(1984)
'یک هزار و نهصد و هشتاد و چهار'
>>> ordinal_words(1232)
'یک هزار و دویست و سی و دوم'
>>> ordinal_words(123)
'یکصد و بیست و سوم'
Obviously, words is used convert to word form and ordinal_words is for ordinal word from.
Use can also pass in floating point numbers:
>>> words(19.75)
'نوزده و هفتاد و پنج صدم'
This is the default setting. If you’d like to use “ممیز” instead of “و” for decimal point, you can:
>>> import num2fawords
>>> num2fawords.DECIMAL_SEPARATOR # default value:
' و '
>>> num2fawords.DECIMAL_SEPARATOR = ' ممیز '
>>> words(19.75)
'نوزده ممیز هفتاد و پنج صدم'
Also some people prefer, for example, “صد و هفتاد” over its other form “یکصد و هفتاد”. This library uses the second form which is the form used on official Iranian banknotes. But it can be changed:
>>> from num2fawords import HUNDREDS
>>> words(170)
'یکصد و هفتاد'
>>> HUNDREDS[1] = 'صد'
>>> words(170)
'صد و هفتاد'
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for num2fawords-0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45ae6d25c91fa29f1847e0a3bafee55c5f1245880bf829ba45c09e073d71d0a5 |
|
MD5 | 1e295c516ca387097b8544d085ca24a4 |
|
BLAKE2b-256 | 6825bfbdbac958cd4e166a9f2d93d9e6f731390e5a06f151ce0c83872f9acaed |