ویرگول
ورودثبت نام
Nasser Hekmati
Nasser Hekmati
Nasser Hekmati
Nasser Hekmati
خواندن ۶ دقیقه·۶ سال پیش

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

حتما برای شما هم پیش آمده در پروژه خود نیاز به تبدیل تاریخ شمسی به میلادی با برعکس را دارید و یا گاهی اطلاعات تاریخ شمسی را از جایی میخوانید و میخواهید با این تاریخ محاسبات درون کد خود انجام دهید.

درون فرم های خود تاریخ شمسی را ورودی میگیرید و باید اعتبارسنجی کنید همه این امکانات و ویژگی بیشتر در لاراول با پکیج ورتا خواهید داشت.

با هم مروری بر امکانات بی شمار این پکیج که بسیاری از برنامه نویسان با بهبود این پکیج لارول به یکی از کاملترین پکیج موجود کرده اند می اندازیم.

برای مشاهده این پکیج میتوانید به گیت هاب این پکیج مراجعه کنید.

ورتا
ورتا

نحوه استفاده

برای نصب دستور زیر را وارد کنید

$ composer require hekmatinasser/verta

برای بدست آوردن تاریخ و زمان کنونی شمسی، از دستور زیر استفاده کنید

$v = new Verta(); //1396-02-02 15:32:08 $v = verta(); //1396-02-02 15:32:08

برای بدست آوردن تاریخ و زمان به نسبت اکنون، از دستور زیر استفاده کنید

$v = Verta::now(); //1396-02-02 15:32:08 $v = Verta::today(); //1396-03-02 00:00:00 $v = Verta::tomorrow(); // 1396-03-03 00:00:00 $v = Verta::yesterday(); // 1396-03-01 00:00:00

برای بدست آوردن تاریخ و زمان به نسبت اکنون مانند تاریخ زمان پی اچ پی به صورت رشته ، از دستور زیر استفاده کنید

$v = new Verta('now'); // 1399-06-18 15:32:08 $v = new Verta('-1 day'); //1399-06-17 15:07:04 $v = new Verta('+1 month'); //1399-07-17 16:51:09 $v = new Verta('next friday'); //1399-06-21 00:00:00 $v = new Verta('last sunday'); //1399-06-16 00:00:00

برای تبدیل تاریخ میلادی خود به شمسی، از دستور زیر استفاده کنید

$v = new Verta('2016-12-27 14:12:32'); $v = Verta::instance('2016-12-25 11:12:36'); $v = Facades\Verta::instance('2016-12-25 11:12:36');

برای استفاده از عدد تایم استمپ به شمسی، از دستور زیر استفاده کنید

$v = new Verta(1333857600);

برای استفاده از کلاس تاریخ و زمان پی اچ پی به شمسی، از دستور زیر استفاده کنید

$dt = new \Datetime(); return new Verta($dt); // 1395-12-09 15:05:56

برای استفاده از کلاس کربن به شمسی، از دستور زیر استفاده کنید

$c = \Carbon::now(); return verta($c); // 1395-12-09 15:05:56

برای استفاده از تاریخ شمسی به صورت رشته، از دستور زیر استفاده کنید

$v = Verta::parse('1395-10-07 14:12:32'); $v = Verta::parse('1396 مهر 17'); $v = Verta::parseFormat('Y n j','1396 مهر 17');



خصوصیات

برای دریافت مقادیر خصوصیات، از دستورات زیر استفاده کنید

$v = verta(); // 1396-03-14 14:18:23 return $v->year; // 1396 return $v->quarter // 1 return $v->month; // 3 return $v->day; // 14 return $v->hour; // 14 return $v->minute; // 18 return $v->second; // 23 return $v->micro; // 0 return $v->dayOfWeek; // 1 return $v->dayOfYear; // 107 return $v->weekOfYear; // 16 return $v->daysInMonth; // 31 return $v->timestamp; // 1496557661 return $v->timezone; // Asia/Tehran

برای مقدار دهی خصوصیات، از دستورات زیر استفاده کنید

$v = verta(); $v->year = 1395; $v->month = 4; // عدد 13 برای ثبت سال آینده اولین ماه $v->day = 25; $v->hour = 16; $v->minute = 50; $v->second = 42; $v->timestamp = 1496557661; $v->timezone = 'Asia/Baku';



قالب نمایش

برای نمایش تاریخ به شمسی، از دستور زیر استفاده کنید

$v = verta(); return $v->format('Y-n-j H:i'); // 1395-10-7 14:12 return $v->format('%B %d، %Y'); // دی 07، 1395 return $v; //1395-10-07 14:12:32

برای نمایش اختلاف تاریخ به صورت واحد زمانی، از دستور زیر استفاده کنید

درصورتی که تاریخ را وارد نکنید، اختلاف با زمان کنونی محاسبه می شود.

return $v1->formatDifference($v2); // 12 ماه بعد return $v1->formatDifference($v3); // 1 سال قبل return $v1->addDays(25)->formatDifference(); // 4 هفته بعد return $v1->subDays(6)->formatDifference(); // 6 روز قبل return verta()->formatDifference(); // الان

برای نمایش اعداد به صورت حروف، از دستور زیر استفاده کنید

return $v->formatWord('Y'); // یک هزار و سیصد و نود و شش return $v->formatWord('l dS F'); // چهارشنبه بیست و نه ام شهریور return $v->formatWord('d F Y'); // بیست و نه شهریور یک هزار و سیصد و نود و شش return $v->formatWord('r'); // چهارشنبه یک هزار و سیصد و نود و شش, شش, بیست و نه, بیست و دو:چهل و نه:سی و هشت +04:30 return $v->formatWord('d F ') . $v->year; // بیست و نه شهریور 1396


تغییر دادن

برای اضافه یا کم کردن از تاریخ خود، از دستور زیر استفاده کنید

$v = verta(); return $v->addYear(); // 1396-10-07 14:12:32 return $v->addYears(4); // 1399-10-07 14:12:32 return $v->subYear(); // 1394-10-07 14:12:32 return $v->subYears(2); // 1393-10-07 14:12:32
return $v->addMonth(); // 1395-11-07 14:12:32 return $v->addMonths(5); // 1396-03-07 14:12:32 return $v->subMonth(); // 1395-09-07 14:12:32 return $v->subMonths(2); // 1395-08-07 14:12:32
return $v->addWeek(); // 1395-10-12 14:12:32 return $v->addWeeks(3); // 1395-10-26 14:12:32 return $v->subWeek(); // 1395-09-30 14:12:32 return $v->subWeeks(2); // 1395-09-27 14:12:32
return $v->addDay(); // 1395-10-08 14:12:32 return $v->addDays(3); // 1395-10-11 14:12:32 return $v->subDay(); // 1395-10-06 14:12:32 return $v->subDays(2); // 1395-09-05 14:12:32
return $v->addHour(); // 1395-10-07 15:12:32 return $v->addHours(5); // 1395-10-07 19:12:32 return $v->subHour(); // 1395-10-07 13:12:32 return $v->subHours(2); // 1395-10-07 12:12:32
return $v->addMinute(); // 1395-10-07 14:13:32 return $v->addMinutes(3); // 1395-10-07 14:15:32 return $v->subMinute(); // 1395-10-07 14:11:32 return $v->subMinutes(2); // 1395-10-07 14:10:32
return $v->addSecond(); // 1395-10-07 14:12:33 return $v->addSeconds(3); // 1395-10-07 14:12:35 return $v->subSecond(); // 1395-10-07 14:12:31 return $v->subSeconds(2); // 1395-10-07 14:12:30



بررسی و مقایسه

برای اعتبار سنجی تاریخ، از دستور زیر استفاده کنید

return Verta::isLeapYear(1394); // false return Verta::isValidDate(1394, 12, 30); // false return Verta::isValidTime(15, 12, 30); // true

برای محاسبه اختلاف تاریخ ها با یکدیگر، از دستور زیر استفاده کنید

// diff objects together $v1 = verta(); // 1396-03-31 22:21:40 $v2 = verta('2017-06-21 01:21:40'); // 1396-03-31 01:21:40 $v3 = verta('2017-06-20'); // 1396-03-30 15:24:53 return $v1->diffYears($v3); // -1 return $v1->diffMonths($v2); // 11 return $v2->diffMonths(); // -11 مقایسه با زمان کنونی return $v1->diffWeeks($v2); // 51 return $v1->diffDays($v3); // -372 return $v3->diffMinutes(); // 536548 return $v3->diffSeconds(); // 12261931

برای مقایسه تاریخ ها با یکدیگر، از دستور زیر استفاده کنید

return $v1->eq(); // ture alias equalTo() return $v1->ne($v2); // true alias notEqualTo() return $v1->gt($v2); // true alias greaterThan() return $v1->gte($v2); // true alias greaterThanOrEqualTo() return $v1->lt($v2); // false alias lessThan() return $v1->lte($v2); // false alias lessThanOrEqualTo() return $v1->between($v2, $v3); // false



اعتبار سنجی

شما می توانید با اعتبار سنجی لاراول تاریخ های شمسی درون فرم های خود استفاده کنید

شما باید پیام های خطا برای اعتبار سنجی خود در در مسیر فایل های ترجمه خود اضافه کنیدبرای نمونه کد هایی که درون پکیج برای پیام خطا وجود دارد در فایل ترجمه خود قرار دهیدبرای مثال در فایل ترجمه پیام خطا به آرایه عبارات زیر را اضافه کنید

'jdate' => ':attribute تاریخ شمسی معتبر نمی باشد.', 'jdate_equal' => ':attribute تاریخ شمسی برابر :fa-date نمی باشد.', 'jdate_not_equal' => ':attribute تاریخ شمسی نامساوی :fa-date نمی باشد.', 'jdatetime' => ':attribute تاریخ و زمان شمسی معتبر نمی باشد.', 'jdatetime_equal' => ':attribute تاریخ و زمان شمسی مساوی :fa-date نمی باشد.', 'jdatetime_not_equal' => ':attribute تاریخ و زمان شمسی نامساوی :fa-date نمی باشد.', 'jdate_after' => ':attribute تاریخ شمسی باید بعد از :fa-date باشد.', 'jdate_after_equal' => ':attribute تاریخ شمسی باید بعد یا برابر از :fa-date باشد.', 'jdatetime_after' => ':attribute تاریخ و زمان شمسی باید بعد از :fa-date باشد.', 'jdatetime_after_equal' => ':attribute تاریخ و زمان شمسی باید بعد یا برابر از :fa-date باشد.', 'jdate_before' => ':attribute تاریخ شمسی باید قبل از :fa-date باشد.', 'jdate_before_equal' => ':attribute تاریخ شمسی باید قبل یا برابر از :fa-date باشد.', 'jdatetime_before' => ':attribute تاریخ و زمان شمسی باید قبل از :fa-date باشد.', 'jdatetime_before_equal' => ':attribute تاریخ و زمان شمسی باید قبل یا برابر از :fa-date باشد.', 'attributes' => [ 'start_date' => 'تاریخ شروع', 'expire_datetime' => 'تاریخ انقضا', ],


میتوانید با ترکیب اعتبارسنجی تاریخ را بین دو محدوده بررسی کنید

$validate = Validator::make([ 'start_date' => '1389/01/31', 'expire_datetime' => '1397/02/16 12:10:00', ], [ 'start_date' => 'required|jdate:Y/m/d|jdate_after:1388/01/01,Y/m/d|jdate_before:1390/01/01', 'expire_datetime' => 'required|jdatetime|jdatetime_after:1397/02/16 12:09:50,Y/m/d H:i:s|jdatetime_before:1397/02/16 12:11:00', ]); if ($validate->fails()) { dd($validate->messages()->toArray()); } //output array:2 [ "start_date" => array:1 [ 0 => "تاریخ شروع تاریخ شمسی باید قبل از ۱۳۹۰/۰۱/۰۱ باشد." ] "expire_datetime" => array:1 [ 0 => "تاریخ انقضا تاریخ و زمان شمسی باید قبل از ۱۳۹۷/۰۲/۱۶ ۱۲:۱۰:۰۰ باشد." ] ]

امکانات این پکیج بیشتر از موارد گفته شده در این مقاله هست برای استفاده و دیدن امکانات بیشتر میتوانید از مستندات این پکیج استفاده کنید.

لاراول
۳
۲
Nasser Hekmati
Nasser Hekmati
شاید از این پست‌ها خوشتان بیاید