دوران

فارسی

English

فارسی

English

حالت تیره

دوراناکوسیستم متن‌باز تقویم فارسی

ابزاری کامل، دقیق و دوست‌دار توسعه‌دهنده برای تقویم هجری شمسی (جلالی).

شروع کنید
مشاهده در گیت‌هاب
📅

دقیق در طراحی

تبدیل تاریخ‌ها بر پایهٔ الگوریتم آزموده‌شدهٔ Borkowski/jalaali انجام می‌شود و با یک مجموعه تست round-trip روزبه‌روز اعتبارسنجی شده است.

🧩

Immutable و Type-safe

یک DoranDate تغییرناپذیر (immutable)، typeهای قوی در همه‌جا، و buildهای tree-shakeable بدون هیچ runtime dependency در core.

🗣️

NLP فارسیِ منعطف

«فردا» یا «جمعه ساعت ۷ شب» را parse کنید — به‌علاوهٔ Finglish («farda») و حتی متنی که با layout انگلیسیِ کیبورد تایپ شده — همراه با یک confidence score.

🎉

تعطیلات از پیش آماده

تعطیلات ملی، مذهبی و فرهنگی ایران — همراه با امکان ثبت تعطیلات سفارشی.

⚛️

بایندینگ برای هر فریم‌ورک

کامپوننت‌های تقویمِ accessible و سازگار با dark mode برای React، Vue، Svelte و Angular — همه روی یک موتور مشترک، به‌علاوهٔ @doranjs/zod برای اعتبارسنجی فرم‌ها.

🌐

همه‌جا کار می‌کند

Web Componentهای مستقل از framework که در HTML ساده، Vue، Svelte یا هر frameworkی جا می‌گیرند — بدون نیاز به build.

🎨

یک Design System قابل theme

یک design system مینیمال که در آن هر بخش — رنگ‌ها، فونت‌ها، سایه‌ها، borderها، گردی‌ها و فلش‌ها — یک CSS variable است که می‌توانید override کنید.

شروع سریع ​

bash
pnpm add @doranjs/core
ts
import { DoranDate } from '@doranjs/core';

const today = DoranDate.now();

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

DoranDate.fromGregorian(new Date());

Released under the MIT License.

Copyright © 2026 Doran Contributors