Convert dates between the Ge'ez calendar — used in Eritrea and Ethiopia — and the Gregorian calendar, and look up the religious and national holidays that go with it. Zero dependencies, pure Python.
Ge'ez dates are everywhere in Eritrean and Ethiopian life, yet almost no software handles them natively. This library exists so that any app can speak the calendar its users actually live by.
The Ge'ez calendar runs 13 months: twelve months of 30 days, then Pagumen,
a short month of 5 days (6 in a leap year). A year is a leap year when
year % 4 == 3. The new year, Enkutatash, falls on 11 September in the
Gregorian calendar (12 September in the year before a Gregorian leap year), and
the Ge'ez year runs roughly 7 to 8 years behind the Gregorian one.
pip install git+https://github.com/filmons/geez-calendar.gitimport datetime
from geez_calendar import GeezDate, to_geez, to_gregorian
# Gregorian -> Ge'ez
to_geez(datetime.date(2026, 1, 7))
# GeezDate(2018, 4, 29) -> Genna, Christmas
# Ge'ez -> Gregorian
to_gregorian(2019, 1, 1)
# datetime.date(2026, 9, 11) -> Enkutatash, the new year
GeezDate.today()
# GeezDate(2019, 1, 11)date = GeezDate(2019, 1, 11)
date.format("latin") # '11 Meskerem 2019'
date.format("tigrinya") # '11 መስከረም 2019'
date.format("amharic") # '11 መስከረም 2019'from geez_calendar import holidays_for_gregorian_year, fasika
fasika(2026)
# datetime.date(2026, 4, 12) -> Orthodox Easter
for holiday in holidays_for_gregorian_year(2026, country="ER"):
print(holiday.gregorian, holiday.name, holiday.name_tigrinya)
# 2026-01-07 Genna (Christmas) ልደት
# 2026-01-19 Timket (Epiphany) ጥምቀት
# 2026-04-12 Fasika (Easter) ፋሲካ
# 2026-05-24 Eritrean Independence Day ናጽነት ኤርትራ
# 2026-09-11 Enkutatash (New Year) ሓዲሽ ዓመት
# ...Fixed feasts are anchored to the Ge'ez calendar, movable ones are computed from
Orthodox Easter, and national holidays can be filtered with country="ER" or
country="ET".
geez-calendar today -l tigrinya
# 11 መስከረም 2019 (2019-01-11)
geez-calendar to-geez 2026-01-07
# 2026-01-07 -> 29 Tahsas 2018
geez-calendar to-gregorian 2019-1-11
# 11 Meskerem 2019 -> 2026-09-21
geez-calendar holidays 2026 --country ERBoth calendars are mapped onto the Julian Day Number, a continuous day count, which makes the conversion exact and reversible in both directions with integer arithmetic only. The test suite round-trips every date from 1900 to 2100 and checks a set of published reference dates.
- ✅ Ge'ez ↔ Gregorian conversion, leap years, Pagumen
- ✅ Month names in Tigrinya, Amharic and Latin script
- ✅ Orthodox fixed and movable feasts, Eritrean and Ethiopian national holidays
- ❌ Islamic holidays — they follow the Hijri lunar calendar, out of scope here
- ❌ Ge'ez numerals and time-of-day reckoning — planned, contributions welcome
git clone https://github.com/filmons/geez-calendar.git
cd geez-calendar
pip install -e ".[dev]"
pytest -q
ruff check .Corrections from Eritrean and Ethiopian readers are especially welcome — holiday names, spellings in Tigrinya and Amharic, and regional differences between the two traditions. Open an issue or a pull request.
MIT — see LICENSE.