آموزش: طریقه استفاده از data time picker فارسی

سلام دوست عزیز،
برای استفاده از DateTimePicker فارسی در پروژه‌های ASP.NET Web Forms، می‌توانید از یک کتابخانه یا اسکریپت جاوااسکریپت مانند PersianDatepicker یا MDPersianDatePicker استفاده کنید. این ابزارها به شما امکان می‌دهند تا یک کالندر فارسی را به صفحه وب خود اضافه کنید و با تاریخ‌های فارسی کار کنید.

در ادامه، یک روش کامل برای استفاده از MDPersianDatePicker در ASP.NET Web Forms توضیح داده می‌شود:

1. افزودن کتابخانه MDPersianDatePicker

ابتدا باید فایل‌های لازم برای کتابخانه MDPersianDatePicker را به پروژه خود اضافه کنید. می‌توانید این کتابخانه را از GitHub یا با استفاده از نرم‌افزار Package Manager (مانند NuGet) دانلود کنید.

گزینه ۱: دانلود مستقیم

فایل‌های css و js کتابخانه را از لینک بالا دانلود کرده و در پوشه‌های مناسب در پروژه خود ذخیره کنید.

گزینه ۲: استفاده از NuGet

با استفاده از Package Manager Console، دستور زیر را وارد کنید:
Install-Package MD.PersianDateTimePicker
. اضافه کردن فایل‌های CSS و JS به صفحه

در فایل aspx خود، فایل‌های CSS و JS مربوط به کتابخانه را اضافه کنید. مثلاً:
<head>

    <title>صفحه با DateTimePicker فارسی</title>

    

    <link href="~/Content/persian-datepicker.min.css" rel="stylesheet" />

</head>

<body>

    <form id="form1" runat="server">

        <div>

            <label for="txtDate">انتخاب تاریخ:</label>

            <input type="text" id="txtDate" name="txtDate" />

        </div>

    </form>



    

    <script src="~/Scripts/jquery.min.js"></script>

    <script src="~/Scripts/persian-date.min.js"></script>

    <script src="~/Scripts/persian-datepicker.min.js"></script>



    <script>

        $(document).ready(function () {

            // ایجاد DateTimePicker فارسی

            $('#txtDate').persianDatepicker({

                format: 'YYYY/MM/DD', // قالب تاریخ

                initialValueType: 'persian' // نوع مقدار اولیه (فارسی)

            });

        });

    </script>

</body>
. تنظیمات اختیاری

شما می‌توانید تنظیمات مختلفی را برای MDPersianDatePicker تنظیم کنید. برخی از تنظیمات مفید شامل موارد زیر هستند:

format قالب تاریخ (مثال: YYYY/MM/DD, DD-MM-YYYY)

altFormat قالب تاریخ جایگزین (اگر بخواهید تاریخ را به صورت دیگر ذخیره کنید)

minDate تاریخ حداقل قابل انتخاب

maxDate
تاریخ حداکثر قابل انتخاب

observer
مشاهده تغییرات در تاریخ و اجرای عملیات خاص

مثال:
$('#txtDate').persianDatepicker({

    format: 'YYYY/MM/DD',

    minDate: '1400/01/01', // حداقل تاریخ

    maxDate: '1405/12/30', // حداکثر تاریخ

    observer: true,       // مشاهده تغییرات

    altFormat: 'X'        // ذخیره تاریخ به عنوان تایم‌استمپ

});
. دریافت مقادیر انتخاب شده

مقادیر انتخاب شده توسط کاربر از طریق Request.Form در کد C#‎ قابل دسترسی است. مثال:
protected void Page_Load(object sender, EventArgs e)

{

    if (IsPostBack)

    {

        string selectedDate = Request.Form["txtDate"];

        // انجام عملیات مورد نظر با selectedDate

    }

}

format	قالب تاریخ (مثال: YYYY/MM/DD, DD-MM-YYYY)
altFormat	قالب تاریخ جایگزین (اگر بخواهید تاریخ را به صورت دیگر ذخیره کنید)
minDate	تاریخ حداقل قابل انتخاب
maxDate	تاریخ حداکثر قابل انتخاب
observer	مشاهده تغییرات در تاریخ و اجرای عملیات خاص