Zemen · ዘመን

Ethiopian ⇆ Gregorian calendar dates for JavaScript. የኢትዮጵያ እና የግሪጎሪያን ቀን መቀያየሪያ እና መቅረጫ ላይብረሪ።

▶ Playground

Install

npm i zemen        # or: bun add zemen

Usage

import Zemen from 'zemen';               // ESM, default import
import { Zemen } from 'zemen';           // ESM, named import
const Zemen = require('zemen');          // CommonJS

// today, in the Ethiopian calendar
const zare = new Zemen();
zare.toString();                         // '2018-11-5'
zare.format('d ፣ MMMM DD ቀን YYYY E');    // 'እሑድ ፣ ሐምሌ 05 ቀን 2018 ዓ.ም'

// Gregorian → Ethiopian
const ken = Zemen.fromGregorian('2017-09-02');
ken.toString();                           // '2009-12-27'
ken.getMonthName();                       // 'ነሐሴ'
ken.getDayOfWeek();                       // 'ቅዳሜ'

// Ethiopian → Gregorian
new Zemen(2009, 11, 27).toGregorian();   // Date: Sat Sep 02 2017

// the 13th month, ጳጉሜን
new Zemen(2011, 12, 5).format('MMMM D YYYY');  // 'ጳጉሜን 5 2011'

API

Zemen mirrors the read API of JavaScript's Date — months are 0-based (0 = መስከረም … 12 = ጳጉሜን), like Date#getMonth. Instances are immutable.

| Member | Returns | Description | |---|---|---| | new Zemen() | Zemen | today | | new Zemen('2009-12-27') | Zemen | from an Ethiopian y-m-d string | | new Zemen(2009, 11, 27) | Zemen | from Ethiopian year, month, day | | Zemen.fromGregorian(date) | Zemen | from a JS Date, a date string, or (y, m, d) | | .toGregorian() | Date | this date in the Gregorian calendar | | .format(pattern?) | string | tokens below; no pattern → 'y-m-d' | | .toString() | string | 'y-m-d' (month 1-based) | | .getFullYear() | number | Ethiopian year | | .getMonth() | number | Ethiopian month, 0-based | | .getDate() | number | day of month | | .getDay() | number | weekday, 0 = Sunday | | .getMonthName() | string | month name in Amharic | | .getDayOfWeek() | string | weekday name in Amharic |

Format tokens

For new Zemen(2009, 11, 27) — ቅዳሜ, ነሐሴ 27, 2009:

| Token | Output | | Token | Output | |---|---|---|---|---| | YYYY / Y | 2009 | | DD | 27 | | YY | 09 | | D | 27 | | MMMM | ነሐሴ | | DDD / d | ቅዳሜ | | MMM | ነሐሴ | | e | 6 | | MM / M | 12 | | E | ዓ.ም |

Any other character is copied through: format('d ፣ MMM DD ቀን YYYY E') → 'ቅዳሜ ፣ ነሐሴ 27 ቀን 2009 ዓ.ም'

Credits

• Conversion algorithm: geez.org EthiopicCalendar.java (Beyene–Kudlek).
• Test data: Appleyard & Girma Selasse Asfaw (Oxford, 1979) and Calendrica.
• Author: m3hari — መሐሪ ጌታ · MIT