import { toEC, toGC } from 'kenat';
 
const eth = toEC(2025, 6, 2);
console.log(eth); 
// → { year: 2017, month: 9, day: 25 }
 
const gc = toGC(2017, 9, 25);
console.log(gc); 
// → { year: 2025, month: 6, day: 2 }

import 'package:kenat/kenat.dart';
 
void main() {
  final eth = toEC(2025, 6, 2);
  print(eth);
  // → {year: 2017, month: 9, day: 25}
 
  final gc = toGC(2017, 9, 25);
  print(gc);
  // → {year: 2025, month: 6, day: 2}
}

from kenat import to_ec, to_gc
 
eth = to_ec(2025, 6, 2)
print(eth)
# {'year': 2017, 'month': 9, 'day': 25}
 
gc = to_gc(2017, 9, 25)
print(gc)
# 2025-06-02

use Kenat\Conversions;
 
// toEC()/toGC() return typed EthiopianDate/GregorianDate value objects
$eth = Conversions::toEC(2025, 6, 2);
echo "{$eth->year}-{$eth->month}-{$eth->day}";
// → 2017-9-25
 
$gc = Conversions::toGC(2017, 9, 25);
echo "{$gc->year}-{$gc->month}-{$gc->day}";
// → 2025-6-2

const k = new Kenat('2016/10/5');
console.log(k.formatInGeezAmharic());
// → መስከረም ፭ ፳፻፲፮

final k = Kenat('2016/10/5');
print(k.formatInGeezAmharic());
// → ሰኔ ፭ ፳፻፲፮

from kenat import Kenat
 
k = Kenat('2016/10/5')
print(k.format_in_geez_amharic())
# → ሰኔ ፭ ፳፻፲፮

use Kenat\Kenat;
 
$k = new Kenat('2016/10/5');
echo $k->formatInGeezAmharic();
// → ሰኔ ፭ ፳፻፲፮

const k = new Kenat('2015/6/10');
 
// These methods mutate the instance and are chainable
k.addDays(5).addMonths(-1).addYears(2);
 
console.log(k.getEthiopian());
// → { year: 2017, month: 5, day: 15 }

var k = Kenat('2015/6/10');
 
// These methods are chainable, but (unlike JS) each one returns a new,
// immutable Kenat instance rather than mutating in place — reassign.
k = k.addDays(5).addMonths(-1).addYears(2);
 
print(k.getEthiopian());
// → {year: 2017, month: 5, day: 15}

from kenat import Kenat
from kenat.day_arithmetic import add_days, add_months, add_years
 
k = Kenat('2015/6/10')
 
# The functions return a new Kenat instance
k = add_days(k, 5)
k = add_months(k, -1)
k = add_years(k, 2)
 
print(k.get_ethiopian())
# → {'year': 2017, 'month': 5, 'day': 15}

use Kenat\Kenat;
 
$k = new Kenat('2015/6/10');
 
// Kenat is immutable in PHP too: these methods return a NEW instance,
// but they still chain.
$k = $k->addDays(5)->addMonths(-1)->addYears(2);
 
$et = $k->getEthiopian();
echo "{$et->year}-{$et->month}-{$et->day}";
// → 2017-5-15

const a = new Kenat('2015/5/15');
const b = new Kenat('2012/5/15');
 
console.log(a.diffInDays(b));    // 1095
console.log(a.diffInMonths(b));  // 39
console.log(a.diffInYears(b));   // 3

final a = Kenat('2015/5/15');
final b = Kenat('2012/5/15');
 
print(a.diffInDays(b));   // 1095
print(a.diffInMonths(b)); // 39
print(a.diffInYears(b));  // 3

from kenat import Kenat
from kenat.day_arithmetic import diff_in_days, diff_in_months, diff_in_years
 
a = Kenat('2015/5/15')
b = Kenat('2012/5/15')
 
print(diff_in_days(a, b))    # 1096
print(diff_in_months(a, b))  # 39
print(diff_in_years(a, b))   # 3

use Kenat\Kenat;
 
$a = new Kenat('2015/5/15');
$b = new Kenat('2012/5/15');
 
echo $a->diffInDays($b);   // 1095
echo $a->diffInMonths($b); // 39
echo $a->diffInYears($b);  // 3

import { MonthGrid } from 'kenat';
 
const grid = new MonthGrid(2017, 9, { useGeez: true });
 
console.log(grid.headers);
// → [ "እሑድ", "ሰኞ", "ማክሰኞ", ... ]
 
console.log(grid.days[0]);
// → { ethiopian: { day: 1 }, gregorian: { day: 9 }, holiday: null }

import 'package:kenat/kenat.dart';
 
// createMonthGrid() returns a Map<String, dynamic> directly
final grid = createMonthGrid({ 'year': 2017, 'month': 9, 'useGeez': true });
 
print(grid['headers']);
// → [ሰኞ, ማክሰኞ, ረቡዕ, ሐሙስ, ዓርብ, ቅዳሜ, እሑድ]
 
// grid['days'] is a flat, weekStart-padded list — leading entries can be
// null, so find the first real day rather than assuming index 0:
final days = grid['days'] as List;
final firstDay = days.firstWhere((d) => d != null);
print(firstDay);
// → {ethiopian: {year: ፳፻፲፯, month: ግንቦት, day: ፩}, gregorian: {year: 2025, month: 5, day: 9}, weekday: 5, weekdayName: ዓርብ, isToday: false, holidays: []}

from kenat.month_grid import MonthGrid
 
# The create method returns the grid directly
grid = MonthGrid.create(year=2017, month=9, use_geez=True)
 
print(grid['headers'])
# → [ 'እሑድ', 'ሰኞ', 'ማክሰኞ', ... ]
 
# Accessing a day in the grid
# The grid is a list of weeks, and weeks are lists of days
first_day_of_first_week = grid['days'][0][0]
print(first_day_of_first_week)

use Kenat\MonthGrid;
 
// MonthGrid::create() returns an array directly — same shape as Dart's
$grid = MonthGrid::create(['year' => 2017, 'month' => 9, 'useGeez' => true]);
 
print_r($grid['headers']);
// → [እሑድ, ሰኞ, ማክሰኞ, ...]
 
// $grid['days'] is a flat, weekStart-padded array — leading entries can
// be null, so find the first real day rather than assuming index 0:
$firstDay = array_values(array_filter($grid['days'], fn ($d) => $d !== null))[0];
print_r($firstDay);
// → ['ethiopian' => [...], 'gregorian' => [...], 'weekday' => ..., 'holidays' => [...]]

import { getHoliday, getHolidaysForYear, getHolidaysInMonth, HolidayTags } from 'kenat';
 
// Get a holiday by key and year
const enkutatash = getHoliday('enkutatash', 2017);
console.log(enkutatash);
// → { key: 'enkutatash', tags: [...], name: 'አዲስ ዓመት', description: 'Ethiopian New Year', ethiopian: { year: 2017, month: 1, day: 1 } }
 
// Get all public holidays for a year
const publicHolidays = getHolidaysForYear(2017, { filter: HolidayTags.PUBLIC });
console.log(publicHolidays);
 
// Get holidays for a specific month
const monthHolidays = getHolidaysInMonth(2017, 1, { filter: HolidayTags.PUBLIC });
console.log(monthHolidays);
 
// Use language option
const meskelEn = getHoliday('meskel', 2017, { lang: 'english' });
console.log(meskelEn.name); // 'Meskel'

import 'package:kenat/kenat.dart';
 
void main() {
  // Get a holiday by key and year
  final enkutatash = getHoliday('enkutatash', 2017);
  print(enkutatash);
  // → {key: enkutatash, tags: [public, cultural], movable: false, name: እንቁጣጣሽ, description: ..., ethiopian: {year: 2017, month: 1, day: 1}}
 
  // Get all public holidays for a year
  final publicHolidays = getHolidaysForYear(2017, { 'filter': HolidayTags.public });
  print(publicHolidays.length); // 15
 
  // Get holidays for a specific month
  final monthHolidays = getHolidaysInMonth(2017, 1, { 'filter': HolidayTags.public });
  print(monthHolidays.length); // 3
 
  // Use language option
  final meskelEn = getHoliday('meskel', 2017, { 'lang': 'english' });
  print(meskelEn?['name']); // 'Finding of the True Cross (Meskel)'
}

from kenat.holidays import get_holiday
 
# Get holiday by its key and year
enkutatash = get_holiday('enkutatash', 2017)
print(enkutatash)
# → {'key': 'enkutatash', 'tags': ['national', 'christian'], 'movable': False, 'name': 'አዲስ ዓመት', 'description': 'Ethiopian New Year', 'ethiopian': {'year': 2017, 'month': 1, 'day': 1}}

use Kenat\Holidays;
use Kenat\HolidayTags;
 
// Get a holiday by key and year — returns a typed Holiday value object, or null
$enkutatash = Holidays::getHoliday('enkutatash', 2017);
echo "{$enkutatash->name}: {$enkutatash->ethiopian->month}/{$enkutatash->ethiopian->day}";
// → አዲስ ዓመት: 1/1
 
// Get all public holidays for a year
$publicHolidays = Holidays::getHolidaysForYear(2017, ['filter' => HolidayTags::PUBLIC]);
echo count($publicHolidays); // 15
 
// Get holidays for a specific month
$monthHolidays = Holidays::getHolidaysInMonth(2017, 1, ['filter' => HolidayTags::PUBLIC]);
echo count($monthHolidays); // 3
 
// Use the lang option
$meskelEn = Holidays::getHoliday('meskel', 2017, ['lang' => 'english']);
echo $meskelEn->name; // 'Meskel'