https://virgool.ir/feed/@hekmati.nasserfa2026-11-11 11:36:01https://files.virgool.ir/upload/users/827722/avatar/avatar.pnghttps://virgool.ir/@hekmati.nasserhttps://virgool.ir/@hekmati.nasser/چرا-پلاگین-تاریخ-شمسی-ورتا-به-ورژن-8-رسید-ph2qkhef6kjbورتا پلاگین تاریخ شمسیسلامدر پلاگین تاریخ شمسی ورتا چه کارهای جدیدی کردی که یک ورژن اصلی دادی و از ورژن 2 یکباره به 8 رسید؟ خلاصه بگم تمام مجموع توابعی که باید با افزوده شدن اون ها ورژن اصلی رخ میداد در نظر گرفته شد 5 قابلیت جدید هم اضافه شد. با توجه به اینکه مدت کوتاهی به پایان ساپورت php 7.4 نمونده بود از 2 ماه گذشته برنامه ریزی کردیم تا ورژن جدید سازگار با 8 ارائه بدم تو این نسخه پلاگین شمسی ورتا کار دیگه ای که کردم این بود برای بقیه فریم ورک php از لاراول جدا شد این قابلیت میده شما در سیموفونی و ... حتی در cms ها از نسخه مخصوص php استفاده کنید که اسمشو جلالی گذاشتم و ورتا از پکیج جلالی استفاده میکنه و اومده اعتبار سنجی های مخصوص لاراول نوشته شده.بهبود الگوریتم ها کار دیگه ای بود که باید برای سرعت کار انجام میشد تا به مراتب هم کد کمتر و هم سریعتری با محاسبات کمتری ارائه میشد. بعضی از قسمت های محاسبات نمیشد با پکیج carbon یا datatime php نوشت و این محسابات سعی کردم ساده کنم که نتیجه اش خیلی خوب شد علاوه بر اون از بعضی امکانات نسخه 8 php استفاده کردم که کار ساده تر میکردافزوده شدن exception ها کار دیگه ای بود که تو این ورژن اومد و exceptionها مخصوص هر عملیات اضافه شد این قابلیت میده تا بتونید در هنگام کار با تاریخ دقیقا متوجه بشید خطای اتفاق افتاده بخاطر چیه و چه پارامتری اشتباه ارسال شده.یک تریت مخصوص بررسی مقادیر زمانی اضافه شده و قراره بیشتر بشه و کلی امکانات سنجش اعتبار تاریخ بهمون بده و بتونیم همشون در ریکوئست بررسی شد.داکیومنت جدید فقط زبان انگلیسی هست وسعی شده فرست قابل جستجو داشته باشه که سریعتر بتونید به خواسته هاتون برسید. همچنین یک قالب مشخص برای هر متد تریف شده که ورودی ها و خروجی ها و توضیحات و ... داخلش هست.برنامه های جالبی داریم ان شا الله بتونم همشو بزنم.Nasser HekmatiNasser HekmatiFri, 29 Jul 2022 22:02:58 +0430https://virgool.ir/@hekmati.nasser/تبدیل-تاریخ-میلادی-به-تاریخ-شمسی-و-بالعکس-در-لاراول-hs6trxa3odysحتما برای شما هم پیش آمده در پروژه خود نیاز به تبدیل تاریخ شمسی به میلادی با برعکس را دارید و یا گاهی اطلاعات تاریخ شمسی را از جایی میخوانید و میخواهید با این تاریخ محاسبات درون کد خود انجام دهید.درون فرم های خود تاریخ شمسی را ورودی میگیرید و باید اعتبارسنجی کنید همه این امکانات و ویژگی بیشتر در لاراول با پکیج ورتا خواهید داشت.با هم مروری بر امکانات بی شمار این پکیج که بسیاری از برنامه نویسان با بهبود این پکیج لارول به یکی از کاملترین پکیج موجود کرده اند می اندازیم.برای مشاهده این پکیج میتوانید به گیت هاب این پکیج مراجعه کنید.ورتانحوه استفادهبرای نصب دستور زیر را وارد کنید$ 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:32return $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:32return $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:32return $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:32return $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:32return $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:32return $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 HekmatiNasser HekmatiWed, 21 Apr 2021 22:31:10 +0430