Welcome to ethioqen’s documentation

Contents:

• Calendar Conversion
  • convert_ethiopian_to_gregorian()
  • convert_gregorian_to_ethiopian()
  • is_ethiopian_leap_year()
  • is_gregorian_leap_year()
• Time Conversion
  • convert_from_ethiopian_time()
  • convert_to_ethiopian_time()
• Unix Time Conversion
  • ethiopian_to_unix()
  • unix_to_ethiopian()
• Utilities
  • get_ethiopian_month_length()
  • is_ethiopian_leap_year()
  • is_valid_eth_time()
  • is_valid_ethiopian_date()
  • is_valid_time()
• Exceptions
  • InvalidDateException
  • InvalidTimeException

Ethiopian Calendar and Time Conversion

ethioqen is a Python library for converting between Ethiopian and Gregorian calendars, Ethiopian and standard time formats, and handling Unix timestamps with timezone support.

Installation

pip install ethioqen

Quick Start

Calendar Conversion

from ethioqen.calendar_conversion import convert_ethiopian_to_gregorian

greg_year, greg_month, greg_day = convert_ethiopian_to_gregorian(2016, 7, 6)
print(f"{greg_year}-{greg_month}-{greg_day}")  # 2024-3-15

Time Conversion

from ethioqen.time_conversion import convert_to_ethiopian_time

eth_hour, eth_minute, is_day = convert_to_ethiopian_time(14, 30)
print(f"{eth_hour}:{eth_minute} {'AM' if is_day else 'PM'}")  # 8:30 PM

Unix Time Conversion

from ethioqen.unix_time_conversion import ethiopian_to_unix

timestamp = ethiopian_to_unix(2016, 7, 6, 8, 30, tz_offset=3)
print(timestamp)  # Unix timestamp for Ethiopian date/time

Indices and tables

• Index

• Module Index

• Search Page