markdown

Ethiopian Calendar Converter 🇪🇹

A lightweight and accurate JavaScript/TypeScript library to convert dates between the Gregorian and Ethiopian calendar systems. It handles leap years and the unique 13th month (Pagumē) of the Ethiopian calendar.

📦 Installation

Install using your preferred package manager. Using npm or yarn:

npm

npm  install  ethiopian-calendar-new

yarn

yarn  add  ethiopian-calendar-new

🚀 Usage

Importing

You can use either ES Modules or CommonJS:

ES Modules (recommended):

short snippet

import  {  toGregorian,  toEthiopian  }  from  'ethiopian-calendar-new';

  

//  Ethiopian  to  Gregorian

console.log(toGregorian(2017,  11,  19));

//  ➜  {  year:  2025,  month:  7,  day:  26  }

  

//  Gregorian  to  Ethiopian

console.log(toEthiopian(2025,  7,  26));

//  ➜  {  year:  2017,  month:  11,  day:  19  }

import and CommonJS require syntax

CommonJS (Node.js):

const  {  toGregorian,  toEthiopian  }  =  require('ethiopian-calendar-new');

  

🔄  Convert  Ethiopian  →  Gregorian

  

const  ethiopianDate  =  {  year:  2017,  month:  1,  day:  1  };

const  gregorian  =  toGregorian(ethiopianDate.year,  ethiopianDate.month,  ethiopianDate.day);

  

console.log(gregorian); //  {  year:  2024,  month:  9,  day:  11  }

  

📘 API

toGregorian(year,  month,  day) → converts Ethiopian → Gregorian



toEthiopian(year,  month,  day) → converts Gregorian → Ethiopian

🙏 Acknowledgments

Calculations based on the Ethiopian calendar system.