DoranThe Open Source Persian Calendar Ecosystem

A complete, accurate, and developer-friendly toolkit for the Solar Hijri (Jalali) calendar.

📅

Accurate by design

Conversion uses the battle-tested Borkowski/jalaali algorithm, validated by an exhaustive day-by-day round-trip test suite.

🧩

Immutable & typed

An immutable DoranDate, strong types everywhere, and tree-shakeable builds with zero runtime dependencies in the core.

🗣️

Forgiving Persian NLP

Parse «فردا» or «جمعه ساعت ۷ شب» — plus Finglish («farda») and even text typed with the keyboard left in English — with a confidence score.

🎉

Holidays included

Iranian national, religious, and cultural holidays — with custom holiday registration.

⚛️

Bindings for every framework

Accessible, dark-mode-aware calendar components for React, Vue, Svelte, and Angular — all on one shared engine, plus @doranjs/zod for form validation.

🌐

Works anywhere

Framework-agnostic Web Components drop into plain HTML, Vue, Svelte, or any framework — no build step required.

🎨

Elegant, themeable UI

A minimal design system where every part — colors, fonts, shadows, borders, radii, arrows — is a CSS variable you can override.

Quick start

bash

pnpm add @doranjs/core

import { DoranDate } from '@doranjs/core';

const today = DoranDate.now();

today.format('YYYY/MM/DD'); // "۱۴۰۵/۰۳/۱۱"
today.addDays(10).format('dddd D MMMM YYYY');
today.toGregorian(); // native Date

DoranDate.fromGregorian(new Date());