GeezDate

A Python package for calculating and converting dates between the Ethiopian (Geez) and Gregorian calendars.

Features

• Convert dates between Ethiopian (Geez) and Gregorian calendars.
• Format Ethiopian dates in Amharic, Tigrigna, or English.
• Simple, intuitive API for developers.
• Utility functions for date formatting and localization.

Installation

pip install geezdate

Requirements: Python 3.11 or later.

Usage

Basic usage with conversion and formatting:

from geezdate import GeezDate, FormatType
import datetime

# Convert Gregorian to Ethiopian (Geez)
gregorian = datetime.date(2024, 5, 1)
geez = GeezDate.from_date(gregorian)
print(f"Gregorian: {gregorian} → Geez: {geez}")  # Example: Gregorian: 2024-05-01 → Geez: 2016-08-23

# Convert Geez back to Gregorian
print(f"Geez: {geez} → Gregorian: {geez.to_date}")

# Format the Geez date in different languages
print(geez.format('.d/.m/.y', FormatType.Amharic))   # 23/08/2016 (Amharic)
print(geez.format('.D .M .Y', FormatType.Tigrigna))  # ረቡዕ ግንቦት 2016 (Tigrigna)
print(geez.format('.D, .M .y (.E)', FormatType.English))  # WEDNESDAY, MAY 16 (GC)

Or run the demo function:

from geezdate import demo
demo()
# Output: Hello, World!

Project Structure

geezdate/
│
├── src/
│   ├── __init__.py
│   ├── geezdate.py
│   ├── format.py
│   └── demo.py
├── test/
│   └── main.py
└── pyproject.toml

Development

Run the test/demo script:

python test/main.py

Or to run the simple demo:

python -m src

License

This project is licensed under the MIT License.

Contact

• Author: Kidus
• Email: kidus.meab@gmail.com
• GitHub: kidusdev/geezdate

Issues

Found a bug or have a feature request? Open an issue.