UNPKG

kenat

Version:

A JavaScript library for the Ethiopian calendar with date and time support.

www.kenat.systems

MelakuDemeke/kenat

97 lines (54 loc) β€’ 3.04 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
## add nextMonth, previousMonth, nextYear, previousYear methods for calendar navigation ## πŸ”Ή Core Features to Add These are essential for most calendar applications. 1. **Conversion Enhancements** * [ ] Support conversion both ways: `toEC()` and `toGC()` renate this to better dev friendly names like toGregorian() and toEthiopian(). TODO: rename these methods. * [ ] Accept JavaScript `Date` object directly (and return one too). * [ ] Add parsing and formatting helpers for ISO-8601 (`YYYY-MM-DD`). 2. **Date Arithmetic** * [ ] Add/subtract days, months, years on Ethiopian dates. Add already added, work on subtracting. * [x] Get difference between two Ethiopian dates in days/months/years. 3. **Validation** * [ ] Validate Ethiopian dates (e.g. Pagume has 5 or 6 days only). * [ ] Throw helpful errors for invalid dates. 4. **Leap Year Helpers** * [x] `.isLeapYear()` method for both Ethiopian and Gregorian dates. * [ ] `.daysInMonth()` method for any month/year combo. --- ## πŸ”Ή Display & Formatting Features 5. **Localized Formatting** * [ ] Support `format()` for multiple languages: `amharic`, `english`, `oromo`, etc. * [ ] Add options for different formats: long (e.g. β€œ15 Meskerem 2017”), short (e.g. β€œ15/01/2017”), etc. 6. **Geez Numerals Everywhere** * [x] Add option to display full date in Geez: "መሡከረም ፲፭ ፳፻፲፯" and also time in Geez (if relevant). 7. **Pretty Today** * [x] `Kenat.today()` returns a `Kenat` for current date. * [ ] `.isToday()` to check if the stored Ethiopian date is today. --- ## πŸ”Ή Advanced Calendar Features 8. **Weekday Support** * [ ] `.getWeekday()` – returns day of the week in Amharic or English. * [ ] Support for calculating holidays based on weekdays (e.g. Meskel always falls on Wednesday one week after finding the true cross). 9. **Holiday Support** * [x] Built-in support for major Ethiopian holidays (Fasika, Meskel, Timket, Enkutatash, etc.). * [ ] Ability to list holidays in a given Ethiopian year. / added a method to list in month will list the year too. 10. **Week Numbers** * [ ] `.getWeekNumber()` for Ethiopian calendar (ISO-style). --- ## πŸ”Ή Utility / Developer-Friendly Features 11. **Static Utilities** * [ ] `Kenat.isValidEthiopianDate(y, m, d)` * [ ] `Kenat.parse(string)` to convert from formatted string. 12. **CLI Tool (Optional)** * [ ] CLI tool to convert and format dates (`kenat convert 2017/01/15 --to=gregorian`). 13. **Calendar View Generator** * [x] Function to return an array of days for a given month (e.g., for building UIs). * [x] Optional metadata (weekday, holiday, isToday, etc.). --- ## Bonus / Fun Features 14. **Date Range Generator** * [ ] Generate all dates between two Ethiopian dates. 15. **Countdown to Next Holiday** * [ ] `.daysUntil('meskel')` or `.daysUntilNextHoliday()` 16. **Ethiopian Time Support** * [x] Format times in Ethiopian 12-hour system (e.g., β€œ3:00 in the morning” = 9:00 AM Gregorian)