Formatting Ethiopian Dates with Kenat

The kenat.formatting module provides a collection of functions to format Kenat date objects into various string representations. You can combine these with the Time class for time-aware formatting.

You can format dates in two ways:

Using instance methods on a Kenat object (e.g., date.format(...), date.formatInGeezAmharic(), date.toISOString()).
Using named formatting functions (e.g., formatStandard(date), formatWithWeekday(date), etc.) imported from kenat.

All formatting functions return strings suitable for display. Invalid date or time objects will throw an error (e.g., InvalidEthiopianDateError, InvalidTimeError).

Formatting Functions

Here are the primary functions available for formatting dates in JavaScript. All formatting functions can be used as instance methods on a Kenat object or as named functions imported from kenat. Invalid date or time objects will throw an error (e.g., InvalidEthiopianDateError, InvalidTimeError).

Standard Date Format

Formats a date into a standard “Month Day Year” string.

undefined


import { Kenat, formatStandard } from 'kenat';
 
// Kenat constructor supports string/object/Date
const today = new Kenat('2016/1/10');
// or: new Kenat({ year: 2016, month: 1, day: 10 })
// or: new Kenat(new Date(2016, 0, 10))
 
// Using Kenat instance method (default Amharic)
console.log(today.format());
// Output: መስከረም 10 2016
 
// Using Kenat instance method (English)
console.log(today.format({ lang: 'english' }));
// Output: Meskerem 10 2016
 
// Using named formatting function
console.log(formatStandard(today));
// Output: መስከረም 10 2016
console.log(formatStandard(today, 'english'));
// Output: Meskerem 10 2016

undefined


import 'package:kenat/kenat.dart';
 
// Kenat's plain constructor accepts a string, a map, or a DateTime
final today = Kenat('2016/1/10');
// or: Kenat({ 'year': 2016, 'month': 1, 'day': 10 })
// or: Kenat(DateTime(2016, 1, 10))
 
// Using Kenat instance method (default Amharic)
print(today.format());
// Output: መስከረም 10 2016
 
// Using Kenat instance method (English)
print(today.format(lang: 'english'));
// Output: Meskerem 10 2016
 
// Using the named formatting function — note it takes the raw
// {year, month, day} map, not the Kenat instance itself
print(formatStandard(today.getEthiopian()));
// Output: መስከረም 10 2016
print(formatStandard(today.getEthiopian(), 'english'));
// Output: Meskerem 10 2016

undefined


from kenat import Kenat
from kenat.formatting import format_standard
 
today = Kenat('2016/1/10')
 
# Default Amharic output
print(format_standard(today))
# Output: መስከረም 10 2016
 
# English output
print(format_standard(today, lang='english'))
# Output: Meskerem 10 2016

undefined


use Kenat\Kenat;
use Kenat\Formatting;
 
// Kenat's constructor accepts a string, an array, or a DateTimeInterface
$today = new Kenat('2016/1/10');
// or: new Kenat(['year' => 2016, 'month' => 1, 'day' => 10])
// or: new Kenat(new DateTimeImmutable('2016-01-10'))
 
// Using Kenat instance method (default Amharic)
echo $today->format();
// Output: መስከረም 10 2016
 
// Using Kenat instance method (English)
echo $today->format(['lang' => 'english']);
// Output: Meskerem 10 2016
 
// Using the named formatting function — takes the EthiopianDate value
// object, not the Kenat instance itself
echo Formatting::formatStandard($today->getEthiopian());
// Output: መስከረም 10 2016
echo Formatting::formatStandard($today->getEthiopian(), 'english');
// Output: Meskerem 10 2016

Date Format with Weekday

Includes the day of the week in the output.

undefined


import { Kenat, formatWithWeekday } from 'kenat';
 
const today = new Kenat('2016/1/10');
 
// Using Kenat instance method
console.log(today.formatWithWeekday());
// Output: ማክሰኞ, መስከረም 10 2016
console.log(today.formatWithWeekday('english', true));
// Output: Tuesday, Meskerem ፲ ፳፻፲፮
 
// Using named formatting function
console.log(formatWithWeekday(today));
// Output: ማክሰኞ, መስከረም 10 2016
console.log(formatWithWeekday(today, 'english', true));
// Output: Tuesday, Meskerem ፲ ፳፻፲፮
// Options: lang ('amharic'|'english'), useGeez (boolean)

undefined


import 'package:kenat/kenat.dart';
 
final today = Kenat('2016/1/10');
 
// Using Kenat instance method
print(today.formatWithWeekday());
// Output: ሐሙስ, መስከረም 10 2016
print(today.formatWithWeekday('english', true));
// Output: Thursday, Meskerem ፲ ፳፻፲፮
 
// Using named formatting function (takes the {year, month, day} map)
print(formatWithWeekday(today.getEthiopian()));
// Output: ሐሙስ, መስከረም 10 2016
print(formatWithWeekday(today.getEthiopian(), 'english', true));
// Output: Thursday, Meskerem ፲ ፳፻፲፮
// Options: lang ('amharic'|'english'), useGeez (boolean)

undefined


from kenat import Kenat
from kenat.formatting import format_with_weekday
 
today = Kenat('2016/1/10')
 
# Weekday in Amharic
print(format_with_weekday(today))
# Output: ማክሰኞ, መስከረም 10 2016
 
# Weekday with Geez numerals
print(format_with_weekday(today, use_geez=True))
# Output: ማክሰኞ, መስከረም ፲ ፳፻፲፮

undefined


use Kenat\Kenat;
use Kenat\Formatting;
 
$today = new Kenat('2016/1/10');
 
// Using Kenat instance method
echo $today->formatWithWeekday();
// Output: ሐሙስ, መስከረም 10 2016
echo $today->formatWithWeekday('english', true);
// Output: Thursday, Meskerem ፲ ፳፻፲፮
 
// Using named formatting function (takes the EthiopianDate value object)
echo Formatting::formatWithWeekday($today->getEthiopian());
// Output: ሐሙስ, መስከረም 10 2016
echo Formatting::formatWithWeekday($today->getEthiopian(), 'english', true);
// Output: Thursday, Meskerem ፲ ፳፻፲፮
// Args: lang ('amharic'|'english'), useGeez (bool)

Date Format with Time

Combines a date and a Time object into a single string.

undefined


import { Kenat, Time, formatWithTime } from 'kenat';
 
const today = new Kenat('2016/1/10');
const time = new Time(8, 30, 'day');
 
// Using Kenat instance method
console.log(today.formatWithTime(time));
// Output: መስከረም 10 2016 8:30 ቀን
 
// Using named formatting function
console.log(formatWithTime(today, time));
// Output: መስከረም 10 2016 8:30 ቀን
// Options: lang ('amharic'|'english'), useGeez (boolean)

undefined


import 'package:kenat/kenat.dart';
 
final today = Kenat('2016/1/10');
final time = Time(8, 30, 'day');
 
// The Kenat instance method doesn't take a Time argument — attach the
// time to the instance first with setTime(), which returns a new Kenat.
final todayWithTime = today.setTime(time);
print(todayWithTime.formatWithTime());
// Output: መስከረም 10 2016 08:30 ጠዋት
 
// The named formatting function does take a Time directly
print(formatWithTime(today.getEthiopian(), time));
// Output: መስከረም 10 2016 08:30 ጠዋት
// Options: lang ('amharic'|'english')

undefined


from kenat import Kenat, Time
from kenat.formatting import format_with_time
 
today = Kenat('2016/1/10')
time = Time(8, 30, 'day')
 
print(format_with_time(today, time))
# Output: መስከረም 10 2016 8:30 ቀን

undefined


use Kenat\Kenat;
use Kenat\Time;
use Kenat\Formatting;
 
$today = new Kenat('2016/1/10');
$time = new Time(8, 30, 'day');
 
// The Kenat instance method doesn't take a Time argument — attach the
// time to the instance first with setTime(), which returns a new Kenat.
$todayWithTime = $today->setTime(8, 30, 'day');
echo $todayWithTime->format(['includeTime' => true]);
// Output: መስከረም 10 2016 08:30 ጠዋት
 
// The named formatting function does take a Time directly
echo Formatting::formatWithTime($today->getEthiopian(), $time);
// Output: መስከረም 10 2016 08:30 ጠዋት
// Args: lang ('amharic'|'english')

Geez Numeral Date Format

Formats the date using Ge’ez numerals for the day and year.

undefined


import { Kenat, formatInGeezAmharic } from 'kenat';
 
const today = new Kenat('2016/1/10');
 
// Using Kenat instance method
console.log(today.formatInGeezAmharic());
// Output: መስከረም ፲ ፳፻፲፮
 
// Using named formatting function
console.log(formatInGeezAmharic(today));
// Output: መስከረም ፲ ፳፻፲፮

undefined


import 'package:kenat/kenat.dart';
 
final today = Kenat('2016/1/10');
 
// Using Kenat instance method
print(today.formatInGeezAmharic());
// Output: መስከረም ፲ ፳፻፲፮
 
// Using named formatting function (takes the {year, month, day} map)
print(formatInGeezAmharic(today.getEthiopian()));
// Output: መስከረም ፲ ፳፻፲፮

undefined


from kenat import Kenat
from kenat.formatting import format_in_geez_amharic
 
today = Kenat('2016/1/10')
print(format_in_geez_amharic(today))
# Output: መስከረም ፲ ፳፻፲፮

undefined


use Kenat\Kenat;
use Kenat\Formatting;
 
$today = new Kenat('2016/1/10');
 
// Using Kenat instance method
echo $today->formatInGeezAmharic();
// Output: መስከረም ፲ ፳፻፲፮
 
// Using named formatting function (takes the EthiopianDate value object)
echo Formatting::formatInGeezAmharic($today->getEthiopian());
// Output: መስከረም ፲ ፳፻፲፮

Short Date Format

Returns the date in a compact YYYY/MM/DD format.

undefined


import { Kenat, formatShort } from 'kenat';
 
const today = new Kenat('2016/1/10');
 
// Using Kenat instance method
console.log(today.formatShort());
// Output: 2016/01/10
 
// Using named formatting function
console.log(formatShort(today));
// Output: 2016/01/10

undefined


import 'package:kenat/kenat.dart';
 
final today = Kenat('2016/1/10');
 
// Using Kenat instance method
print(today.formatShort());
// Output: 2016/01/10
 
// Using named formatting function (takes the {year, month, day} map)
print(formatShort(today.getEthiopian()));
// Output: 2016/01/10

undefined


from kenat import Kenat
from kenat.formatting import format_short
 
today = Kenat('2016/1/10')
print(format_short(today))
# Output: 2016/01/10

undefined


use Kenat\Kenat;
use Kenat\Formatting;
 
$today = new Kenat('2016/1/10');
 
// Using Kenat instance method
echo $today->formatShort();
// Output: 2016/01/10
 
// Using named formatting function (takes the EthiopianDate value object)
echo Formatting::formatShort($today->getEthiopian());
// Output: 2016/01/10

ISO Date String Format

Returns an ISO-like string, with optional time.

undefined


import { Kenat, Time, toISODateString } from 'kenat';
 
// Date only
const today = new Kenat('2016/1/10');
console.log(today.toISOString());
// Output: 2016-01-10
console.log(toISODateString(today));
// Output: 2016-01-10
 
// With time
const time = new Time(8, 30, 'day');
// Kenat does not accept time in constructor, set time via setTime
today.setTime(8, 30, 'day');
console.log(today.toISOString());
// Output: 2016-01-10T08:30
console.log(toISODateString(today, time));
// Output: 2016-01-10T08:30

undefined


import 'package:kenat/kenat.dart';
 
final today = Kenat('2016/1/10');
 
// Note: a string-constructed Kenat always carries a default noon-day
// time internally, so toISOString() already includes a time component.
print(today.toISOString());
// Output: 2016-01-10T12:00
 
// The named function takes the raw date map with no implicit time:
print(toISODateString(today.getEthiopian()));
// Output: 2016-01-10
 
// With an explicit time — setTime() returns a NEW Kenat instance
final todayWithTime = today.setTime(8, 30, 'day');
print(todayWithTime.toISOString());
// Output: 2016-01-10T08:30
print(toISODateString(today.getEthiopian(), { 'hour': 8, 'minute': 30, 'period': 'day' }));
// Output: 2016-01-10T08:30

undefined


from kenat import Kenat, Time
from kenat.formatting import to_iso_date_string
 
today = Kenat('2016/1/10')
 
# Date only
print(to_iso_date_string(today))
# Output: 2016-01-10
 
# With time
time = Time(8, 30, 'day')
print(to_iso_date_string(today, time))
# Output: 2016-01-10T08:30

undefined


use Kenat\Kenat;
use Kenat\Formatting;
 
$today = new Kenat('2016/1/10');
 
// Note: like Dart, a string-constructed Kenat always carries a default
// noon-day time internally, so toISOString() already includes a time.
echo $today->toISOString();
// Output: 2016-01-10T12:00
 
// The named function takes the EthiopianDate value object with no
// implicit time:
echo Formatting::toISODateString($today->getEthiopian());
// Output: 2016-01-10
 
// With an explicit time — setTime() returns a NEW Kenat instance
$todayWithTime = $today->setTime(8, 30, 'day');
echo $todayWithTime->toISOString();
// Output: 2016-01-10T08:30
echo Formatting::toISODateString($today->getEthiopian(), ['hour' => 8, 'minute' => 30, 'period' => 'day']);
// Output: 2016-01-10T08:30