Skip to content

yinebebt/ethiocal

Repository files navigation

logo

Go Reference ci-badge Go Report Card

Description

The Ethiopian calendar(ባሕረ-ሀሳብ) is used to get Fasting and Holiday's specific date with in a year based on EOTC calendar. It also designed to facilitate the conversion between Ethiopian dates (in the format yy-mm-dd) and Gregorian dates. Ethiopia follows its own calendar system, which consists of 13 months, each with 30 days.

Functionality

This tool allows users to:

  • Get Ethiopian fasting and religious festival dates for a specific year.
  • Convert Ethiopian dates to Gregorian dates.
  • Convert Gregorian dates to Ethiopian dates.

Usage

The tool can be used in two ways:

  1. Run on Your Own Server:

    • Run the server by configuring it locally or on a cloud provider.
  2. CLI Usage:

    • A comprehensive command-line interface (CLI) is available for direct usage.
    • The CLI supports the following commands:
      • bahir: Get Ethiopian fasting and religious festival dates for a given year.
      • convert: Convert dates between Ethiopian and Gregorian calendars.
      • help: Help on usage.

Examples:

To get religious dates for a specific Ethiopian year:

ethiocal bahir 2017

To convert a Gregorian date to Ethiopian:

ethiocal convert gtoe 2025-02-02

To convert an Ethiopian date to Gregorian:

ethiocal convert etog 2017-05-25

To enable server mode:

ethiocal --cli=false

Installation

Install using the following Go command:

go install github.com/yinebebt/ethiocal@latest