Skip to content
Projects

majidh1/JalaliDatePicker

View on GitHub

majidh1/JalaliDatePicker has 668 GitHub stars and 90 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 22:35 UTC. Last push 2026-10-18.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A lightweight and simple jalali datepicker. powerful javascript datepicker with no dependencies

Developer Tools

README.md

Original

JalaliDatePicker

npm version License

یک datepicker سبک و بدون وابستگی برای انتخاب تاریخ جلالی، زمان، یا تاریخ و زمان در صفحات وب.

فهرست

نصب

نصب با npm

npm i @majidh1/jalalidatepicker

سپس فایل‌های CSS و JS خروجی را در صفحه اضافه کنید:

<link rel="stylesheet" href="jalalidatepicker.min.css">
<script src="jalalidatepicker.min.js"></script>

استفاده از CDN

<link rel="stylesheet" href="https://unpkg.com/@majidh1/jalalidatepicker/dist/jalalidatepicker.min.css">
<script src="https://unpkg.com/@majidh1/jalalidatepicker/dist/jalalidatepicker.min.js"></script>

استفاده دستی از dist

می‌توانید فایل‌های آماده را از پوشه dist بردارید:

dist/jalalidatepicker.min.css
dist/jalalidatepicker.min.js

شروع سریع

به input مورد نظر attribute زیر را اضافه کنید:

<input data-jdp>

بعد از load شدن فایل JS، datepicker را فعال کنید:

<script>
 jalaliDatepicker.startWatch();
</script>

از این لحظه هر input که با selector پیش‌فرض input[data-jdp] match شود، هنگام focus شدن datepicker را نمایش می‌دهد.

API عمومی

بعد از اضافه کردن فایل JS، یک object سراسری به نام jalaliDatepicker ساخته می‌شود:

jalaliDatepicker.startWatch(options);
jalaliDatepicker.show(input);
jalaliDatepicker.hide();
jalaliDatepicker.updateOptions(options);
متد توضیح
startWatch(options) فعال‌سازی datepicker روی inputهای مطابق selector
show(input) نمایش دستی datepicker برای یک HTMLInputElement
hide() بستن datepicker فعلی
updateOptions(options) به‌روزرسانی تنظیمات بعد از startWatch

مثال‌ها

انتخاب تاریخ

<input data-jdp>

<script>
 jalaliDatepicker.startWatch();
</script>

انتخاب تاریخ و زمان

<input data-jdp>

<script>
 jalaliDatepicker.startWatch({
  date: true,
  time: true,
  hasSecond: true
 });
</script>

فقط زمان

<input data-jdp data-jdp-only-time>
<input data-jdp data-jdp-only-time data-jdp-has-second="false">

<script>
 jalaliDatepicker.startWatch({
  time: true,
  hasSecond: "attr"
 });
</script>

محدود کردن بازه تاریخ

<input data-jdp>

<script>
 jalaliDatepicker.startWatch({
  minDate: {
   year: 1403,
   month: 1,
   day: 10
  },
  maxDate: {
   year: 1403,
   month: 12,
   day: 29
  }
 });
</script>

خواندن محدودیت‌ها از attribute

<input
 data-jdp
 data-jdp-min-date="1403/01/10"
 data-jdp-max-date="1403/12/29"
>

<script>
 jalaliDatepicker.startWatch({
  minDate: "attr",
  maxDate: "attr"
 });
</script>

ذخیره مقدار میلادی در input دیگر

<input data-jdp>
<input id="gregorian-date">

<script>
 jalaliDatepicker.startWatch({
  targetValueInput: "#gregorian-date",
  targetValueType: "gregorian"
 });
</script>

اگر کاربر 1403/01/01 را انتخاب کند، مقدار target به صورت 2024-03-20 نوشته می‌شود.

انتخاب بازه تاریخ

<input data-jdp>

<script>
 jalaliDatepicker.startWatch({
  mode: "range",
  rangeSeparator: " - "
 });
</script>

با انتخاب 1403/01/01 و 1403/01/05 مقدار input برابر 1403/01/01 - 1403/01/05 می‌شود. حالت‌های range و multiple خروجی را به صورت فقط تاریخ می‌نویسند.

انتخاب چند تاریخ

<input data-jdp>

<script>
 jalaliDatepicker.startWatch({
  mode: "multiple",
  multipleSeparator: ", "
 });
</script>

تاریخ‌های انتخاب‌شده مرتب می‌شوند و به صورت لیست جداشده نوشته می‌شوند، مثلا 1403/01/01, 1403/01/05. حالت‌های range و multiple خروجی را به صورت فقط تاریخ می‌نویسند.

تعیین حالت انتخاب برای هر input

<input data-jdp data-jdp-mode="range">
<input data-jdp data-jdp-mode="multiple">

<script>
 jalaliDatepicker.startWatch({
  mode: "attr"
 });
</script>

وقتی mode برابر "attr" باشد، هر input حالت انتخاب خودش را از data-jdp-mode می‌خواند. مقدارهای معتبر: single، range و multiple.

سفارشی‌سازی روزها با dayRendering

jalaliDatepicker.startWatch({
 dayRendering(dayOptions, input) {
  if (dayOptions.weekDay === 6) {
   return {
    ...dayOptions,
    isValid: false
   };
  }

  return {
   isHoliday: dayOptions.month === 1 && dayOptions.day <= 4,
   className: dayOptions.month === 1 && dayOptions.day <= 4 ? "nowruz" : "",
   isValid: dayOptions.isValid
  };
 }
});

با dayRendering می‌توانید روزها را disabled کنید، class اضافه کنید، یا روز را به عنوان تعطیل نمایش دهید. مقدار weekDay هم داخل dayOptions در دسترس است؛ در ترتیب پیش‌فرض روزهای شمسی، شنبه 0 و جمعه 6 است.

Options

کلید مقدار پیش‌فرض توضیح
date true فعال بودن انتخاب تاریخ
time false فعال بودن انتخاب زمان
hasSecond true نمایش dropdown ثانیه در حالت زمان. با مقدار "attr" از data-jdp-has-second هر input خوانده می‌شود
initDate تاریخ امروز یا مقدار input تاریخ اولیه نمایش داده‌شده
initTime زمان فعلی سیستم زمان اولیه نمایش داده‌شده
minDate undefined حداقل تاریخ مجاز. می‌تواند object، مقدار "today" یا "attr" باشد
maxDate undefined حداکثر تاریخ مجاز. می‌تواند object، مقدار "today" یا "attr" باشد
minTime undefined حداقل زمان مجاز. می‌تواند object یا "attr" باشد
maxTime undefined حداکثر زمان مجاز. می‌تواند object یا "attr" باشد
today تاریخ سیستم تاریخ امروز برای highlight و دکمه امروز
selector "input[data-jdp]" selector مربوط به نمایش خودکار
container "body" محل ساخته شدن datepicker و overlay
zIndex 1000 z-index datepicker
autoShow true نمایش خودکار هنگام focus روی inputهای مطابق selector
autoHide true بستن خودکار هنگام کلیک بیرون از datepicker و input
autoReadOnlyInput وابسته به موبایل بودن مرورگر readonly شدن input هنگام نمایش datepicker
hideAfterChange true بستن datepicker بعد از تغییر مقدار
hideAfterChangeWithTime false بستن datepicker بعد از تغییر مقدار حتی وقتی time فعال است
changeMonthRotateYear false چرخش سال هنگام رفتن از ماه ۱۲ به ۱ یا برعکس
showTodayBtn true نمایش دکمه امروز
showEmptyBtn true نمایش دکمه خالی/پاک کردن
showCloseBtn وابسته به موبایل بودن مرورگر نمایش دکمه بستن
showSelectTimeBtnAlways false نمایش همیشگی دکمه انتخاب در حالت فقط زمان
useDropdownYears true استفاده از dropdown برای سال. نام قدیمی useDropDownYears هم برای سازگاری پشتیبانی می‌شود
position "left" محل قرارگیری نسبت به input. مقدارهای مجاز: "left", "right", "center"
topSpace 0 فاصله datepicker از input وقتی زیر input است
bottomSpace 0 فاصله datepicker از input وقتی بالای input است
overflowSpace -10 فاصله مجاز از لبه پنجره هنگام جلوگیری از خروج از صفحه
minuteIncrement 1 گام دقیقه‌ها در dropdown زمان
hourIncrement 1 گام ساعت‌ها در dropdown زمان
mode "single" حالت انتخاب تاریخ. مقدارهای مجاز: "single", "range", "multiple", "attr"
rangeSeparator " - " جداکننده تاریخ شروع و پایان در حالت range
multipleSeparator ", " جداکننده تاریخ‌ها در حالت multiple
persianDigits false نمایش ارقام فارسی به جای ارقام انگلیسی
days ["ش", "ی", "د", "س", "چ", "پ", "ج"] نام روزهای هفته
months نام ماه‌های فارسی نام ماه‌ها در dropdown ماه
separatorChars object جداکننده‌های تاریخ/زمان و target
targetValueInput undefined selector یا HTMLInputElement برای نوشتن مقدار تبدیل‌شده. با "attr" از data-jdp-target-value-input خوانده می‌شود
targetValueType undefined اگر "gregorian" باشد مقدار target به میلادی تبدیل می‌شود. با "attr" از data-jdp-target-value-type خوانده می‌شود
plusHtml SVG داخلی HTML دکمه افزایش سال/ماه
minusHtml SVG داخلی HTML دکمه کاهش سال/ماه
dayRendering undefined callback برای تغییر وضعیت یا ظاهر روزها

ساختار object تاریخ و زمان

const date = {
 year: 1403,
 month: 1,
 day: 1
};

const time = {
 hour: 13,
 minute: 45,
 second: 0
};

تنظیم separatorChars

jalaliDatepicker.startWatch({
 separatorChars: {
  date: "/",
  between: " ",
  time: ":",
  targetDate: "-",
  targetBetween: " ",
  targetTime: ":"
 }
});

Attributeهای input

این attributeها روی هر input قابل استفاده‌اند:

Attribute توضیح
data-jdp فعال کردن datepicker برای input
data-jdp-init-date تاریخ اولیه input
data-jdp-min-date حداقل تاریخ مجاز
data-jdp-max-date حداکثر تاریخ مجاز
data-jdp-min-time حداقل زمان مجاز
data-jdp-max-time حداکثر زمان مجاز
data-jdp-only-date فقط انتخاب تاریخ برای این input
data-jdp-only-time فقط انتخاب زمان برای این input
data-jdp-has-second نمایش یا عدم نمایش ثانیه برای این input وقتی hasSecond: "attr" باشد. برای حذف ثانیه مقدار "false" بگذارید
data-jdp-mode حالت انتخاب برای این input وقتی mode: "attr" باشد. مقدارهای معتبر: single، range، multiple
data-jdp-target-value-input selector مربوط به input مقصد
data-jdp-target-value-type نوع مقدار مقصد، مثل gregorian

مثال با attributeهای هر input:

<input
 data-jdp
 data-jdp-init-date="1403/01/01"
 data-jdp-min-date="1403/01/10"
 data-jdp-max-date="1403/12/29"
 data-jdp-target-value-input="#gregorian-date"
 data-jdp-target-value-type="gregorian"
>
<input id="gregorian-date">

<script>
 jalaliDatepicker.startWatch({
  initDate: "attr",
  minDate: "attr",
  maxDate: "attr",
  targetValueInput: "attr",
  targetValueType: "attr"
 });
</script>

Eventها

بعد از تغییر مقدار input، این eventها روی همان input dispatch می‌شوند:

  • jdp:change
  • change
  • input

مثال:

document.querySelector("input[data-jdp]").addEventListener("jdp:change", function (event) {
 console.log(event.target.value);
});

فرمت مقدارها

فرمت پیش‌فرض تاریخ:

1403/01/09

فرمت پیش‌فرض زمان:

13:05:00

فرمت پیش‌فرض تاریخ و زمان:

1403/01/09 13:05:00

اگر hasSecond: false باشد، زمان بدون ثانیه نوشته می‌شود:

13:05

نمونه‌ها

توسعه و build

نصب وابستگی‌ها:

npm install

اجرای محیط توسعه:

npm run dev

اجرای تست‌ها:

npm test

بررسی lint:

npm run lint

ساخت خروجی production:

npm run build

خروجی‌های اصلی در پوشه dist ساخته می‌شوند:

dist/jalalidatepicker.css
dist/jalalidatepicker.js
dist/jalalidatepicker.min.css
dist/jalalidatepicker.min.js

لینک‌ها