---
id: bangla
version: "0.0.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# bangla — Bangla is a Python package for converting Gregorian dates to the Bengali calendar, translating English numerals to Bangla numerals, and generating Bangla ordinals for dates.

License: permissive · Maintenance: active · Downloads: 95.9K/mo

## What it is and what it does

Bangla is a calendar and numeral conversion library for Bengali language applications. It converts Gregorian dates into the revised Bengali calendar officially adopted in Bangladesh in 1987, returning structured data for year, month, day, weekday, season, and ordinal. It also translates English digit strings into their Bangla numeral equivalents. The package has no external dependencies and runs on Linux, macOS, and Windows.

The library is designed for developers building Bengali-language applications, localization tools, or calendar interfaces that need accurate Bengali date representation. It handles the full calendar computation automatically and provides both programmatic access and human-readable Bangla text output for all calendar components.

Use it for:

- Display current or historical dates in Bengali calendar format within a Bengali-language web or mobile application.
- Convert user-entered Gregorian dates to Bengali calendar for cultural or administrative purposes in Bangladesh.
- Translate numeric data (IDs, phone numbers, amounts) into Bangla numerals for display in Bengali interfaces.
- Generate Bengali calendar widgets or date pickers that show weekday, season, and ordinal alongside the date.
- Localize date output in Bengali-language reporting or document generation systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts Gregorian dates to the Bengali calendar and translates English numerals to Bangla numerals, returning full calendar details including month, day, weekday, season, and ordinal.

Yes. The package is actively maintained, has zero known vulnerabilities, requires only Python 3.10+, carries no external dependencies, and solves a specific and well-defined problem for Bengali-language applications. MIT licensing removes legal friction. Install it if you need accurate Bengali calendar conversion or Bangla numeral translation.

## Install

pip install bangla
uv add bangla
poetry add bangla

## Installing bangla

Before you install: Low friction: pure Python wheel with no runtime dependencies. Actively maintained with a recent release 67 days ago and a live repository.

License in practice: MIT license permits commercial and private use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install bangla

import bangla
bangla_date = bangla.get_date()
print(bangla_date)
# Output: {'date': '৮', 'month': 'আষাঢ়', 'year': '১৪২৪', 'season': 'বর্ষা', 'weekday': 'বৃহস্পতিবার'}

bangla_numeric = bangla.convert_english_digit_to_bangla_digit("123456")
print(bangla_numeric)
# Output: ১২৩৪৫৬

Requires Python 3.10 or later.

Verify before relying:

- Whether the Bengali calendar implementation matches all regional variants (documentation notes potential differences for Indian Bengali communities).
- Performance characteristics when processing large batches of date conversions.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 95.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bengali calendar conversion, gregorian to bangla date, bangla numeral translator, bengali calendar library, bangla date formatter, english to bangla digits, calendar-conversion, localization, bengali-language

[View on SkillFed](https://skillfed.io/packages/bangla) · [View on PyPI](https://pypi.org/project/bangla/)