تبدیل تاریخ میلادی به شمسی با پکیج در لاراول

اگر شما هم. توسعه‌دهنده یا برنامه‌نویس وبسایت هستید، احتمالا تا کنون نیاز به استفاده از تاریخ شمسی در پروژتان داشته‌اید. اینکه شما خودتان بخواهید که یک اسکریپت PHP را توسعه بدهید کاری وقت‌گیرو سختی هست و ممکن هست که باگ‌های مختلفی در پروژتان وجود داشته باشد؛ حالا اگر ما بخواهیم که به پکیجی که توسعه داده‌ایم، تعدادی محاسبه اضافه کنیم؛ کار کمی سخت‌تر میشود، در این مقاله میخواهیم یکی از پکیج‌های محبوب برای تبدیل تاریخ میلادی به شمسی و برعکس را به شما معرفی کنم و تنها در چند دقیقه اینکار را انجام بدهید.

پکیجی که میخواهم برای این کار به شما معرفی کنم پکیج `morilog/jalali` میباشد.

برای نصب این پکیج شما از دو روش میتوانید این کار را انجام دهید:

1. روش اول (نصب دستی)

در اولین روش شما باید وارد صفحه گیت‌هاب این پکیج به این آدرس شوید

آدرس: https://github.com/morilog/jalali

پس از وارد شدن به صفحه گیت‌هاب روی کلمه سبز `Code` کلیک کنید و بعد روی گزینه `Download Zip` کلیک کنید.

2. روش دوم (نصب با ترمینال)

در دومین روش شما ابتدا باید وارد Terminal یا CMD در سیستم خود شوید و سپس دستور زیر را وارد کنید:

نصب پکیج `morilog/jalali`

composer require morilog/jalali:3.*

طبق توضیحات (Document) پکیج شما الان باید وارد فایل `config/app.php` بشوید و سپس ServiceProvider و Facade را اضافه کنید.

خط زیر را در بخش Providers اضافه کنید:

Morilog\Jalali\JalaliServiceProvider::class,

و در بخش Alias کد زیر را قرار دهید:

'jDate' => Morilog\Jalali\Facades\jDate::class

نصب پکیج با موفیت به پایان رسید.

شما میتوانید در هر بخشی که نیاز به قرار دادن و تبدیل تاریخ میلادی به شمسی داشتید طبق مستندات پکیج اینکار را انجام دهید، برای مثال: 

// the default timestamp is Now
$date = \Morilog\Jalali\Jalalian::now()
// OR
$date = jdate();

// pass timestamps
$date = Jalalian::forge(1333857600);
// OR
$date = jdate(1333857600);

// pass human readable strings to make timestamps
$date = Jalalian::forge('last sunday');

// get the timestamp
$date = Jalalian::forge('last sunday')->getTimestamp(); // 1333857600

// format the timestamp
$date = Jalalian::forge('last sunday')->format('%B %d، %Y'); // دی 02، 1391
$date = Jalalian::forge('today')->format('%A, %d %B %y'); // جمعه، 23 اسفند 97

// get a predefined format
$date = Jalalian::forge('last sunday')->format('datetime'); // 1391-10-02 00:00:00
$date = Jalalian::forge('last sunday')->format('date'); // 1391-10-02
$date = Jalalian::forge('last sunday')->format('time'); // 00:00:00

// get relative 'ago' format
$date = Jalalian::forge('now - 10 minutes')->ago() // 10 دقیقه پیش

برای اطلاعات بیشتر درباره پکیج به شما پیشنهاد میکنم که حتما مستندات پکیج را مطالعه فرمایید.

آدرس: https://github.com/morilog/jalali

در این مقاله با پکیج morilog/jalali برای تبدیل تاریخ شمسی به میلادی آشنا شدید، امیدوارم که این مقاله برای شما مفید واقع شده باشد؛ در صورتی که برای شما در خصوص این مقاله سوالی پیش آمده است، حتما در قسمت کامنت‌ها برای ما ارسال کنید.