Skip to content

README.md

Latest commit

 

History

History
executable file
·
124 lines (83 loc) · 3.34 KB

README.md

File metadata and controls

executable file
·
124 lines (83 loc) · 3.34 KB
Raw

ethiocalendar

PyPI version Downloads Python License: MIT

ethiocalendar is a Python date and time library for the Ethiopian calendar. It converts between Ethiopian and Gregorian dates, detects leap years, and exposes date / datetime objects that mirror the standard library.

Conversion uses the same Ethiopic Amete Mihret epoch as Unicode ICU (JD_EPOCH_OFFSET_AMETE_MIHRET = 1723856, Beyene–Kudlek).

Current release: 1.2.0 (Python 3.6+).

Installation

pip install -U ethiocalendar

What's new in 1.2.0

  • More accurate Ethiopian ↔ Gregorian conversion (ICU / Beyene–Kudlek epoch)
  • Gregorian → Ethiopian no longer fails on Pagume 5 of non-leap years
  • datetime.togregorian() and Pagume strftime work correctly
  • Documented tuple helpers: to_gregorian, from_gregorian, today, is_leap_year
  • Existing methods such as date.togregorian() and fromgretoethio() are unchanged

Features

  • Convert Ethiopian → Gregorian and Gregorian → Ethiopian
  • date and datetime objects with the familiar standard-library methods
  • Today's date in both calendars
  • Ethiopian leap years (Pagume 6 when year % 4 == 3)
  • Round-trip conversions, including Pagume

Quick examples

Object API (existing, unchanged)

import datetime
import ethiocalendar as ec

# Meskerem 1, 2012 EC → September 12, 2019 GC
print(ec.date(2012, 1, 1).togregorian())
# datetime.date(2019, 9, 12)

print(ec.fromgretoethio(datetime.date(2025, 11, 12)))
# ethiocalendar.date(2018, 3, 3)

print(ec.date.today())
print(ec.is_puagume6(2011))  # True

Convenience functions

import ethiocalendar as ec

print(ec.to_gregorian(2012, 1, 1))
# (2019, 9, 12)

print(ec.from_gregorian(2025, 11, 12))
# (2018, 3, 3)

print(ec.today())
# (year, month, day) in the Ethiopian calendar

print(ec.is_leap_year(2011))  # True
print(ec.is_leap_year(2012))  # False

Round-trip

import ethiocalendar as ec

date_ec = (2012, 1, 1)
to_gc = ec.to_gregorian(*date_ec)
back_ec = ec.from_gregorian(*to_gc)
assert date_ec == back_ec

Calendar notes

  • The Ethiopian year has 13 months: 12 × 30 days, plus Pagume (5 days, or 6 in a leap year).
  • Leap years occur every 4 years when year % 4 == 3.
  • Meskerem 1 falls on 11 September in the Gregorian calendar, or 12 September when the following Gregorian year is a leap year. That shortcut holds for Ethiopian years 1900–2091. Because the Ethiopian calendar does not skip century leap days, New Year drifts by one Gregorian day after 2100 (which is not a Gregorian leap year).

Tests

pytest -q

Links

Author

Mukerem Ali Nur GitHub · PyPI · Downloads