Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Library to work with Farsi (Persian) numbers

Project description


A Library to work with Farsi(Persian) numbers



Use this method to convert an integer into a Persian number. You can select encoding, Persian, Arabic or All possibilities (all combinations of Arabic and Persian digits).

from fanumbers import to_fa_number
print(to_fa_number(85))  # returns a str, in Persian digits
print(to_fa_number(75, 'arabic'))  # returns a str, in Arabic digits
print(to_fa_number(2018, 'all'))  # returns a list of strings, all possibilities


Use this method to convert a number in Persian and Arabic digits to an integer.

from fanumbers import from_fa_number
print(from_fa_number("۸۵۸۵"))  # returns an int, 8585


Use this method to convert int or Arabic/Persian numbers into Persian words.

This method two optional arguments, ordinal which is set to False by default and if set to True will return ordinal numbers instead of cardinal. And all_possibilities which is set to False by default and if set to True, will return a list of all possible writings of the number instead of a single string.

from fanumbers import number_to_words
print(number_to_words(85))  # هشتاد و پنج 
print(number_to_words(7, ordinal=True))  # هفتم
for res in number_to_words(111111111, all_possibilities=True):  # wil return multiple strings

Project details

Download files

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

Files for fanumbers, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size fanumbers-1.0.1-py3-none-any.whl (4.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fanumbers-1.0.1.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page