Skip to content

About

Ge'ez ↔ Gregorian calendar conversion for Eritrean and Ethiopian dates, with holidays. Python library.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

geez-calendar

CI Python License: MIT

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 calendar in one minute

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.

Install

pip install git+https://github.com/filmons/geez-calendar.git

Usage

Converting dates

import 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)

Month names in three scripts

date = GeezDate(2019, 1, 11)

date.format("latin")      # '11 Meskerem 2019'
date.format("tigrinya")   # '11 መስከረም 2019'
date.format("amharic")    # '11 መስከረም 2019'

Holidays

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".

Command line

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 ER

How the conversion works

Both 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.

Scope

  • ✅ 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

Development

git clone https://github.com/filmons/geez-calendar.git
cd geez-calendar
pip install -e ".[dev]"
pytest -q
ruff check .

Contributing

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.

License

MIT — see LICENSE.

About

Ge'ez ↔ Gregorian calendar conversion for Eritrean and Ethiopian dates, with holidays. Python library.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages