معرفی پکیج (کتابخانه) jalali برای کار با تقویم جلالی (جلالی شمسی) در php و laravel
امروز قصد دارم تا یک پکیج مفید برای زبان برنامه نویسی PHP در رابطه با کار با تاریخ فارسی را به شما معرفی کنم. به کمک این پکیج شما می توانید به سادگی از تاریخ جلالی (جلالی شمسی) در تمام پروژه های php خود و بعلاوه پروژه های لاراولی خود استفاده کنید ،پس وقت رو از دست ندید و در ادامه با معرفی این پکیج کاربردی و مید همراه ما باشید.
پکیج jalali که برخی هم اون رو به اسم morilog/jalali میشناسن یک کتابخانه قدرتمند برای کار با تاریخ شمسی یا جلالی است که توسط شخصی به نام مرتضی پروینی (Morteza Parvini) توسعه داده شده و همچنان توسعه داده میشه. البته سازنده این پکیج چندین پکیج مفید دیگه رو هم برای استفاده در برنامه های php ایجاد کرده که در اینجا ما فقط به دنبال معرفی پکیج کار با تقویم جلالی هستیم.
در زیر مختصری از توضیحات نویسنده این پکیج را برای شما آوده ایم:
تقویم جلالی یک تقویم خورشیدی است که در ایران مورد استفاده قرار می گرفته است که نوع تغییر یافته (یا نوع دیگری) از آن نیز هنوز در کشور های ایران و افغانستان مورد استفاده قرار می گیرد. شما می توانید در ویکی پیدیا اطلاعات بیشتری در این رابطه بدست بیاورید. و همچنین می توانید در این لینک اطلاعاتی در رابطه با تبدیل تاریخ ها بدست بیاورید.
در حال حاضر آخرین نسخه ارائه شده برای این کتابخانه نسخه 3.1.2 است که شما می توانید از آن و یا نسخه های قبلی آن استفاده کنید. در این میان باید به یک نکته توجه داشته باشید ،برای استفاده از این کتابخانه شما به حداقل های زیر نیاز دارید:
- حداقل نسخه php: ^7.0 | ^7.1 | ^7.2
- در صورت استفاده از Carbon به nesbot/carbon: ^1.21 || ^2.0
- و یا beberlei/assert: 3.*
پس اگر از نسخه قدیمی تری از php استفاده می کنید شما بایستی یا نسخه php خود را به روز رسانی کنید و یا از نسخه های قدیمی تر این کتابخانه در برنامه خود استفاده کنید.
در زیر نیز برخی از مهمترین ویژگی های نسخه 3 را برای شما لیست کرده ایم:
- API هایی با قابلیت خوانایی بسیار بالا (نزدیک به زبان انسان)
- داشتن API برای مدیریت و دستکاری DateTime
- داشتن API برای مقایسه DateTime
- تغییر ناپذیر (unchangeable)
اگر شما می خواهید از نسخه های 1 آن ستفاده کنید کافیست به آدرس زیر رفته و داکیومنت های آن را مطالعه کنید:
نکته: برای نسخه یک آخرین ورژه ارائه شده نسخه 1.1 آن است.
و همچنین اگر نیاز به نصب نسخه 2 آن را دارید کافیست از داکیومنت آن که در زیر برای شما آماده کرده ایم اقدام به نصب آن کنید:
نکته: برای نسخه 2 آخرین ورژه ارائه شده نسخه 2.3.0 آن است.
در نهایت اگر میخواهید از آخرین نسخه آن (تا امروز) یعنی نسخه 3.1.2 استفاده کنید و یا نسخه بالاتر از آن اگر منتشر شود ،کافیست کد زیر را در آدرس پروژه خود و در ترمینال اجرا کنید:
composer require morilog/jalali:3.*در نهایت می توانید از متد jdate() و یا jDate::forge() استفاده کنید.
برای مثال و به عنوان راهنما می توانید کد های زیر را بررسی کنید تا از نحوه ی کار با این کتابخانه اطلاعات بیشتری بدست بیاورید:
// default timestamp is now
$date = \Morilog\Jalali\jDate::forge();
// یا
$date = jdate();
// ارسال مقادیر تایم استمپ
$date = jDate::forge(1333857600);
// یا
$date = jdate(1333857600);
// ارسال مقادیر رشته ای تایم استمپ با خوانایی انسانی
$date = jDate::forge('last sunday');
// دریافت تایم استمپ
$date = jDate::forge('last sunday')->time(); // 1333857600
// فرمت بندی تایم استمپ
$date = jDate::forge('last sunday')->format('%B %d، %Y'); // دی 02، 1391
// استفاده از قالب های از پیش تعریف شده
$date = jDate::forge('last sunday')->format('datetime'); // 1391-10-02 00:00:00
$date = jDate::forge('last sunday')->format('date'); // 1391-10-02
$date = jDate::forge('last sunday')->format('time'); // 00:00:00
// اصلاح مقدار تایم استمپ به نسبت یک مقدار موجود
$date = jDate::forge('2012-10-12')->reforge('+ 3 days')->format('date'); // 1391-07-24
// استفاده از فرمت 'ago' یا قبل مقلا چند دقیقه قبل
$date = jDate::forge('now - 10 minutes')->ago() // 10 دقیقه پیش
// OR
$date = jdate('now - 10 minutes')->ago() // 10 دقیقه پیش
در نهایت می توانید برای دریافت اطلاعات بیشتر در رابطه با نسب این کتابخانه ،راهنمای استفاده از آن و یا دریافت سورس کد آن و... به آدرس گیت هاب آن که در زیر برای شما دوستان آماده کرده ایم مراجعه کنید:
میتوانید برای مشاهده جزییات این پکیج در سایت packagist نیز از آدرسی که در زیر برای شما دوستان قرار داده ایم استفاده کنید و جززیات بیشتری را در packagist بدست بیاورید:
نظر شما چیست؟ شما می توانید نظرات ،پیشنهادات و اطلاعات خود را در رابطه با این مطلب و موضوعات مربوط از طریق قسمت نظرات با ما و سایر بازدیدکنندگان در میان بگذارید.