sambat

Exact Bikram Sambat (Nepali calendar) dates with the full datetime API.

sambat.date and sambat.datetime work like datetime.date and datetime.datetime, with the year, month and day in the Bikram Sambat (BS) calendar. The calendar-independent types (timedelta, time, timezone, tzinfo, UTC) are the standard library’s own objects.

>>> import sambat
>>> d = sambat.date(2083, 6, 15)
>>> d.to_gregorian()
datetime.date(2026, 10, 1)
>>> d.strftime("%A, %d %B %Y")
'Thursday, 15 Ashwin 2083'
>>> d.weekday() == d.to_gregorian().weekday()
True

Highlights

• Exact, or an error. Month lengths come from a table of officially published years; dates outside it raise instead of being guessed.

• Real datetime parity, checked by tests against the running Python: hashing, pickling, ISO 8601, isocalendar, strptime, fold, time zones, subclassing.

• Nepali formatting and parsing, in English or Devanagari.

• BS calendar arithmetic, periods and Nepal’s fiscal year.

• No dependencies, fully typed, pure Python (CPython 3.11–3.15, free-threaded builds, PyPy).

Installation

$ pip install sambat

Tutorial

• Tutorial
  • Creating dates
  • Converting
  • Today
  • Formatting
  • Parsing
  • Arithmetic
  • Date and time with time zones
  • Calendars

How-to guides

• Migrate from nepali-datetime
• Store dates in databases and APIs
• Work with time zones in Nepal
• Report by Nepal’s fiscal year
• Verify or add a calendar year

Reference

• API reference
  • sambat
  • sambat.calendar
  • sambat.delta
  • sambat.periods
  • sambat.fiscal
  • sambat.locale
  • sambat.text
  • sambat.compat
• Format directives
  • Directives
  • Devanagari digits: %O
  • Locales
  • Parsing rules
• Parity with datetime and calendar
  • Shared with the standard library
  • Intentional differences
• Command line

Explanation

• How the Bikram Sambat calendar works
• The calendar data
• Why sambat is exact or nothing

Project

• Changelog
• GitHub
• PyPI