bornomala

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Getting Started#

Installation#

Install from PyPI (Python 3.5+ required, no extra dependencies):

pip install bornomala-py

With uv:

uv add bornomala-py

With Poetry:

poetry add bornomala-py

Python version support#

Python	Supported
3.5	✅
3.6	✅
3.7	✅
3.8	✅
3.9	✅
3.10	✅
3.11	✅
3.12	✅
3.13	✅

Quick tour#

Numbers in words#

from bornomala import num_to_words, words_to_num

num_to_words(0) # 'শূন্য'
num_to_words(42) # 'বিয়াল্লিশ'
num_to_words(1234) # 'এক হাজার দুইশত চৌত্রিশ'
num_to_words(-7) # 'ঋণাত্মক সাত'
num_to_words("3.14") # 'তিন দশমিক এক চার'
num_to_words("১২৩") # 'একশত তেইশ' ← Bangla digit string accepted

words_to_num("এক হাজার দুইশত চৌত্রিশ") # 1234
words_to_num("তিন দশমিক এক চার") # 3.14

Digit conversion#

from bornomala import to_bangla_digits, to_western_digits

to_bangla_digits(2026) # '২০২৬'
to_bangla_digits(-3.14) # '-৩.১৪'
to_western_digits("২০২৬") # '2026'

Ordinals#

from bornomala import to_bangla_ordinal

to_bangla_ordinal(1) # '১ম'
to_bangla_ordinal(4) # '৪র্থ'
to_bangla_ordinal(6) # '৬ষ্ঠ'
to_bangla_ordinal(11) # '১১তম'

Currency#

from bornomala import format_currency

format_currency(500) # 'পাঁচশত টাকা মাত্র'
format_currency("1234.50") # 'এক হাজার দুইশত চৌত্রিশ টাকা পঞ্চাশ পয়সা মাত্র'

Dates#

from bornomala import BanglaDate, BanglaDatetime

bd = BanglaDate(2026, 3, 12)
str(bd) # '১২ মার্চ ২০২৬'
bd.strftime("%A, %e %B %Y") # 'বৃহস্পতিবার, ১২ মার্চ ২০২৬'

bdt = BanglaDatetime(2026, 3, 12, 10, 30)
str(bdt) # 'বৃহস্পতিবার, ১২ মার্চ ২০২৬, ১০:৩০'

Bangla calendar#

from bornomala import gregorian_to_bangla
from datetime import date

bd = gregorian_to_bangla(date(2026, 3, 12))
str(bd) # '২৮ ফাল্গুন ১৪৩২'
bd.season # 'বসন্ত'

Text utilities#

from bornomala import normalize, is_bangla, is_pure_bangla, bangla_char_count

normalize("আমার সোনার বাংলা") # 'আমার সোনার বাংলা'
normalize("এক|দুই") # 'এক।দুই' (pipe → daari)
is_bangla("hello আমি") # True
is_pure_bangla("আমার বাংলা।") # True
bangla_char_count("hello আমি") # 3

What’s next#

Numbers

Mon, 01 Jan 0001 00:00:00 +0000

Numbers#

Convert integers, floats, and numeric strings to Bangla words and back.

from bornomala import num_to_words, words_to_num

`num_to_words(n)`#

Convert a number to its Bangla word representation (কথায়).

Signature

def num_to_words(n: int | float | str) -> BanglaWords

Parameters

Parameter	Type	Description
`n`	`int`, `float`, or `str`	The number to convert. Strings may contain Western (0–9) or Bangla (০–৯) digits.

Returns — a BanglaWords instance (subclass of str).

Examples#

Integers#

num_to_words(0) # 'শূন্য'
num_to_words(1) # 'এক'
num_to_words(10) # 'দশ'
num_to_words(100) # 'একশত'
num_to_words(1000) # 'এক হাজার'
num_to_words(100000) # 'এক লক্ষ'
num_to_words(10000000) # 'এক কোটি'
num_to_words(1234567) # 'বারো লক্ষ চৌত্রিশ হাজার পাঁচশত সাতষট্টি'

Negative numbers#

num_to_words(-1) # 'ঋণাত্মক এক'
num_to_words(-42) # 'ঋণাত্মক বিয়াল্লিশ'
num_to_words(-1000) # 'ঋণাত্মক এক হাজার'

Decimals#

num_to_words("3.14") # 'তিন দশমিক এক চার'
num_to_words("0.5") # 'শূন্য দশমিক পাঁচ'
num_to_words("-2.5") # 'ঋণাত্মক দুই দশমিক পাঁচ'
num_to_words("1.005") # 'এক দশমিক শূন্য শূন্য পাঁচ'

Bangla digit string input#

num_to_words("১২৩৪") # 'এক হাজার দুইশত চৌত্রিশ'
num_to_words("০") # 'শূন্য'

Place value reference#

Number	Words
100	একশত
1,000	এক হাজার
10,000	দশ হাজার
1,00,000	এক লক্ষ
10,00,000	দশ লক্ষ
1,00,00,000	এক কোটি
10,00,00,000	দশ কোটি
1,00,00,00,000	এক হাজার কোটি

`BanglaWords`#

num_to_words returns a BanglaWords — a str subclass with chainable suffix methods.

Digits

Mon, 01 Jan 0001 00:00:00 +0000

Digits#

Convert between Western ASCII digits (0–9) and Bangla Unicode digits (০–৯).

from bornomala import to_bangla_digits, to_western_digits

Digit mapping#

Western	Bangla
0	০
1	১
2	২
3	৩
4	৪
5	৫
6	৬
7	৭
8	৮
9	৯

`to_bangla_digits(n)`#

Convert Western digits in n to Bangla Unicode digits. Non-digit characters are left unchanged.

Signature

def to_bangla_digits(n: int | float | str) -> str

Examples#

to_bangla_digits(0) # '০'
to_bangla_digits(2026) # '২০২৬'
to_bangla_digits(3.14) # '৩.১৪'
to_bangla_digits(-42) # '-৪২'
to_bangla_digits("3.14") # '৩.১৪'
to_bangla_digits("abc") # 'abc' ← non-digits unchanged
to_bangla_digits("year 2026") # 'year ২০২৬'

Use in formatting#

# Bangla page numbers
pages = [1, 2, 3, 10, 11]
bangla_pages = [to_bangla_digits(p) for p in pages]
# ['১', '২', '৩', '১০', '১১']

# Bangla phone number
phone = "01712-345678"
to_bangla_digits(phone) # '০১৭১২-৩৪৫৬৭৮'

# Bangla year in text
f"সাল: {to_bangla_digits(2026)}" # 'সাল: ২০২৬'

`to_western_digits(text)`#

Convert Bangla Unicode digits in text to Western ASCII digits. Non-digit characters are left unchanged.

Ordinals

Mon, 01 Jan 0001 00:00:00 +0000

Ordinals#

Generate Bangla ordinal strings — ১ম, ২য়, ৪র্থ, ১১তম, and so on.

from bornomala import to_bangla_ordinal

`to_bangla_ordinal(n)`#

Signature

def to_bangla_ordinal(n: int) -> str

Parameters

Parameter	Type	Description
`n`	`int`	A positive integer. Floats are truncated via `int()`.

Raises ValueError for zero or negative input.

Suffix rules#

Range	Suffix	Example
1	ম	১ম
2	য়	২য়
3	য়	৩য়
4	র্থ	৪র্থ
5	ম	৫ম
6	ষ্ঠ	৬ষ্ঠ
7	ম	৭ম
8	ম	৮ম
9	ম	৯ম
10	ম	১০ম
11+	তম	১১তম, ১০০তম …

Full reference table (1–20)#

n	Ordinal	Meaning
1	১ম	প্রথম (first)
2	২য়	দ্বিতীয় (second)
3	৩য়	তৃতীয় (third)
4	৪র্থ	চতুর্থ (fourth)
5	৫ম	পঞ্চম (fifth)
6	৬ষ্ঠ	ষষ্ঠ (sixth)
7	৭ম	সপ্তম (seventh)
8	৮ম	অষ্টম (eighth)
9	৯ম	নবম (ninth)
10	১০ম	দশম (tenth)
11	১১তম	একাদশ (eleventh)
12	১২তম	দ্বাদশ (twelfth)
13	১৩তম	ত্রয়োদশ
14	১৪তম	চতুর্দশ
15	১৫তম	পঞ্চদশ
20	২০তম	বিংশ

Examples#

to_bangla_ordinal(1) # '১ম'
to_bangla_ordinal(2) # '২য়'
to_bangla_ordinal(3) # '৩য়'
to_bangla_ordinal(4) # '৪র্থ'
to_bangla_ordinal(6) # '৬ষ্ঠ'
to_bangla_ordinal(10) # '১০ম'
to_bangla_ordinal(11) # '১১তম'
to_bangla_ordinal(21) # '২১তম'
to_bangla_ordinal(100) # '১০০তম'
to_bangla_ordinal(999) # '৯৯৯তম'

In practice#

# Class rankings
students = ["রাফি", "সিয়াম", "নাফিসা", "তাহমিনা"]
for i, name in enumerate(students, 1):
 print(f"{to_bangla_ordinal(i)} স্থান: {name}")
# ১ম স্থান: রাফি
# ২য় স্থান: সিয়াম
# ৩য় স্থান: নাফিসা
# ৪র্থ স্থান: তাহমিনা

# Exam question numbers
questions = range(1, 6)
for q in questions:
 print(f"{to_bangla_ordinal(q)} প্রশ্ন")
# ১ম প্রশ্ন … ৫ম প্রশ্ন

Error handling#

to_bangla_ordinal(0) # ValueError: requires a positive integer
to_bangla_ordinal(-5) # ValueError: requires a positive integer

Currency

Mon, 01 Jan 0001 00:00:00 +0000

Currency#

Format monetary amounts as cheque-style Bangla strings — the kind you see on bank drafts and official receipts.

from bornomala import format_currency

`format_currency(amount, unit, paisa_unit)`#

Signature

def format_currency(
 amount: int | float | str,
 unit: str = "টাকা",
 paisa_unit: str = "পয়সা",
) -> str

Parameters

Parameter	Default	Description
`amount`	—	The monetary amount. Accepts `int`, `float`, or numeric string (Western or Bangla digits).
`unit`	`"টাকা"`	Main currency unit label.
`paisa_unit`	`"পয়সা"`	Fractional unit label (1/100 of main unit).

Returns a str of the form:

Date & Time

Mon, 01 Jan 0001 00:00:00 +0000

Date & Time#

Bangla-aware wrappers for Python’s datetime.date and datetime.datetime. Same constructors, same methods — all text output in Bangla.

from bornomala import BanglaDate, BanglaDatetime, bangla_strftime
from bornomala import FMT_DATE_LONG, FMT_DATE_SHORT, FMT_DATE_WEEKDAY
from bornomala import FMT_DATETIME_LONG, FMT_DATETIME_SHORT
from bornomala import FMT_TIME_12H, FMT_TIME_24H
from bornomala import timezone, timedelta

`BanglaDate`#

A wrapper for datetime.date that returns Bangla text from strftime and __str__.

Construction#

All three forms are equivalent:

from datetime import date
from bornomala import BanglaDate

BanglaDate(2026, 3, 12) # year, month, day
BanglaDate(date(2026, 3, 12)) # wrap an existing date
BanglaDate.fromisoformat("2026-03-12")
BanglaDate.fromtimestamp(1741737600)
BanglaDate.today()

`strftime(fmt)`#

bd = BanglaDate(2026, 3, 12)

bd.strftime("%e %B %Y") # '১২ মার্চ ২০২৬'
bd.strftime("%A, %e %B %Y") # 'বৃহস্পতিবার, ১২ মার্চ ২০২৬'
bd.strftime("%d/%m/%Y") # '১২/০৩/২০২৬'
bd.strftime("%b %Y") # 'মার্চ ২০২৬'

`str`#

Defaults to FMT_DATE_LONG (%e %B %Y):

Bangla Calendar

Mon, 01 Jan 0001 00:00:00 +0000

Bangla Calendar (বঙ্গাব্দ)#

Convert between the Gregorian calendar and the Revised Bengali Calendar (শংশোধিত বাংলা পঞ্জিকা) as standardised by the Bangla Academy, Bangladesh.

from bornomala import (
 BanglaCalendarDate,
 gregorian_to_bangla,
 bangla_to_gregorian,
 BANGLA_CAL_MONTHS,
 BANGLA_SEASONS,
)
from datetime import date

Calendar overview#

The Revised Bengali Calendar (১৯৮৭):

The new year (পহেলা বৈশাখ) always falls on 14 April (Gregorian).
Months 1–5 have 31 days; months 6–11 have 30 days.
Month 12 (চৈত্র) has 30 days in regular years, 31 in leap years.
The Bangla year = Gregorian year − 593 (on or after 14 April) or − 594 (before 14 April).

Month reference#

#	Month	Season (ঋতু)	Gregorian start
1	বৈশাখ	গ্রীষ্ম	14 April
2	জ্যৈষ্ঠ	গ্রীষ্ম	15 May
3	আষাঢ়	বর্ষা	15 June
4	শ্রাবণ	বর্ষা	16 July
5	ভাদ্র	শরৎ	16 August
6	আশ্বিন	শরৎ	17 September
7	কার্তিক	হেমন্ত	17 October
8	অগ্রহায়ণ	হেমন্ত	16 November
9	পৌষ	শীত	15 December
10	মাঘ	শীত	14 January
11	ফাল্গুন	বসন্ত	13 February
12	চৈত্র	বসন্ত	14 March

`gregorian_to_bangla(gdate)`#

Convert a datetime.date to a BanglaCalendarDate.

Text Utilities

Mon, 01 Jan 0001 00:00:00 +0000

Text Utilities#

Unicode normalisation, script detection, and character utilities for Bangla text.

from bornomala import normalize, is_bangla, is_pure_bangla, bangla_char_count

`normalize(text)`#

Clean and normalise Bangla Unicode text. Applies three fixes in order:

NFC normalisation — canonical Unicode composition (the standard form for storing and comparing Bangla text).
daari repair — replaces the ASCII pipe | with the Bangla daari । when it appears in a Bangla context. This is a common OCR artefact in scanned documents.
Whitespace collapse — collapses consecutive spaces (including no-break spaces U+00A0) to a single space, and strips leading/trailing whitespace.

Signature

bornomala

Getting Started

Getting Started#

Installation#

Python version support#

Quick tour#

Numbers in words#

Digit conversion#

Ordinals#

Currency#

Dates#

Bangla calendar#

Text utilities#

What’s next#

Numbers

Numbers#

num_to_words(n)#

Examples#

Integers#

Negative numbers#

Decimals#

Bangla digit string input#

Place value reference#

BanglaWords#

Digits

Digits#

Digit mapping#

to_bangla_digits(n)#

Examples#

Use in formatting#

to_western_digits(text)#

Ordinals

Ordinals#

to_bangla_ordinal(n)#

Suffix rules#

Full reference table (1–20)#

Examples#

In practice#

Error handling#

Currency

Currency#

format_currency(amount, unit, paisa_unit)#

Date & Time

Date & Time#

BanglaDate#

Construction#

strftime(fmt)#

__str__#

Bangla Calendar

Bangla Calendar (বঙ্গাব্দ)#

Calendar overview#

Month reference#

gregorian_to_bangla(gdate)#

Text Utilities

Text Utilities#

normalize(text)#

`num_to_words(n)`#

`BanglaWords`#

`to_bangla_digits(n)`#

`to_western_digits(text)`#

`to_bangla_ordinal(n)`#

`format_currency(amount, unit, paisa_unit)`#

`BanglaDate`#

`strftime(fmt)`#

`str`#

`gregorian_to_bangla(gdate)`#

`normalize(text)`#