Everything you need to build applications with Ethiopian and Gregorian calendar support.
Seamlessly work with both Ethiopian and Gregorian calendars in a single interface.
Complete date and time selection with customizable formats and time zones.
Full TypeScript support with comprehensive type definitions for better development experience.
Style with Tailwind CSS or standard CSS. Complete control over appearance and behavior.
Built-in support for Amharic and English with extensible localization system.
Lightweight, fast, and optimized for production applications with minimal bundle size.
Get started with Et-Calendar in seconds. Choose your preferred package manager.
npm install et-calendar
Get up and running with Et-Calendar in minutes. Here are the most common use cases.
import React, { useState } from "react";
import { EthiopianDate } from "et-calendar/lib";
import { DatePicker } from "et-calendar";
const App = () => {
const [date, setDate] = useState<Date>(() => new Date());
const [ethDate, setEthDate] = useState(() =>
EthiopianDate.toEth(new Date())
);
const handleDateChange = (newDate: Date) => {
setDate(newDate);
setEthDate(EthiopianDate.toEth(newDate));
};
return (
<DatePicker
selectedDate={date}
onDateChange={handleDateChange}
showCalendars="both" // "gregorian" | "ethiopian" | "both"
viewFirst="Gregorian" // "Gregorian" | "Ethiopian"
dateFormat="MMMM dd, yyyy"
/>
);
};
Try out the Et-Calendar components with live examples. Select dates and see real-time formatting in both calendars.
Experience the power of Et-Calendar with these interactive examples. Try different configurations and see how they work in real-time.
View the selected date in both calendar systems with various formatting options.
Full Date
July 5, 2025
Formatted
2025-07-05
Full Date
ሰኔ 28, 2017
Formatted DateTime
2017-10-28 13:40:52
Explore different formatting options for Ethiopian dates. Each example shows the format string and the resulting output.
Standard date format, commonly used in technical contexts
2017-10-28
Common format used in Ethiopia and many other countries
28/10/2017
Long format with full month name in Amharic
ሰኔ 28, 2017
Abbreviated format with day of week
ቅዳ, ሰኔ 28 2017
Complete format with full day and month names
ቅዳሜ, ሰኔ 28, 2017
Standard datetime format with 24-hour time
2017-10-28 13:40:52
Long datetime format with full month name
ሰኔ 28, 2017 13:40:52
Complete reference for all components, hooks, and utilities in Et-Calendar.
A customizable date picker supporting Ethiopian and Gregorian calendars.
selectedDate?
onDateChange
showCalendars
viewFirst?
dateFormat?
A date-time picker for selecting both dates and times with calendar support.
timeFormat?