تا به‌ حال به این موضوع فکر کرده ‌اید که اگر امکان استفاده از تاریخ در وب سایت‌ها وجود نداشت، چه اتفاقی می‌افتاد؟ تقریبا بدون ثبت و خواندن تاریخ در وب سایت ها، پیاده سازی هیچ کدام از خدماتی که در حال حاضر در سایت‌ها ارائه می‌شوند، کار ساده ای نخواهد بود. ثبت نام کاربران، گزارش‌های مالی، زمان پست‌های ارسالی و... نمونه ای از خدماتی است که با تاریخ در ارتباط اند. بنابراین کار با تاریخ یکی از رایج‌ترین مواردی است که در طراحی و برنامه نویسی سایت‌ها صورت می‌گیرد. کمتر سایت و یا اپلیکیشنی پیدا خواهید کرد که از تاریخ استفاده نکرده باشد.

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

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

ورتا (Verta) پکیجی برای تبدیل تاریخ شمسی و میلادی به یکدیگر است که برای فریم ورک لاراول عرضه شده است. این پکیج توابع کمکی زیادی را شامل می‌شود که کاربران با بکارگیری آن‌ها می‌توانند به راحتی تبدیلات تاریخ را انجام دهند. زبان PHP دارای کلاسی برای تاریخ و زمان است که پکیج ورتا از همین کلاس ارث بری کرده است. ورتا از الگوریتم تبدیل تاریخ شمسی به میلادی و بالعکس استفاده می‌کند. الگوریتم مبدل تاریخی که در این پکیج استفاده شده است بر اساس الگوریتم تاریخ جلالی وحید سهراب لو، روزبه پورنادر و محمد توسی می‌باشد.

برای استفاده از این پکیج در وب اپلیکیشن‌های خود نیاز به نصب و استفاده از کامپوزر (Composer) دارید. کامپوزر یک ابزار کامند لاین است که به منظور کاهش وابستگی نرم افزارها به کتابخانه‌ها و پکیج‌های خارجی ارائه شده است. با استفاده از این ابزار به راحتی می‌توان پکیج‌ها و کتابخانه را دریافت و مدیریت کنید. منبع اصلی پکیج‌ها و کتبخانه‌های کامپوزر سایت Packagist است که به عنوان مخزن پیش‌فرض پروژه‌های PHP شناخته می‌شود. در این سایت توسعه دهندگان مختلف کتابخانه‌ها و پکیج‌های مختلف پروژه ‌های خود را در دسترس سایر توسعه دهندگان قرار می‌دهند.

آموزش نصب Composer

ابتدا باید ابزار کامپوزر را باید دانلود کنید. برای دانلود کامپوزر به سایت رسمی این برنامه به نشانی getcomposer.org مراجعه کنید. برای دانلود آخرین نسخه این برنامه مطابق عکس زیر بر روی Download کلیک کنید.

در صفحه بعد که هدایت می‌شوید، روش‌های مختلفی برای نصب کامپوزر وجود دارد. در این بخش ساده‌ترین روش نصب این ابزار بررسی می‌شود. در این صفحه برای دریافت فایل نصبی کامپوزر بر روی عبارت Composer-Setup.exe کلیک کنید.

پس از دریافت فایل اجرایی کامپوزر، آن را اجرا کنید و مراحل را مانند تصاویر دنبال کنید. در این مرحله از نصب باید نشانی فایل اجرایی php را برای نصب Composer مشخص نمایید. فایل اجرایی PHP معمولا توسط نرم افزارهایی مانند Xampp، Wamp و... نصب می‌شود. البته معمولا فایل نصبی به صورت اتوماتیک آدرس فایل اجرایی PHP را شناسایی می‌کند. اگر نرم‌ افزار نصب نتوانست به صورت خودکار این فایل را شناسایی کند، لازم است تا با زدن دکمه‌ Browse این مرحله را به صورت دستی پیش ببرید. پس انجام این کار بر روی گزینه Next کلیک کنید.

برای نصب این ابزار باید به اینترنت متصل باشید. پس این مرحله، دیگر نیازی به تغییرات و انجام عمل خاصی وجود ندارد و کافی است بر روی گزینه‌های Next و در نهایت Install کلیک کنید. تبریک می‌گویم، کامپوزر شما نصب شده است. اکنون می‌توانیم برای دریافت کتابخانه ورتا از این ابزار استفاده کنیم.

نصب کتابخانه Verta

$ composer require hekmatinasser/verta

حال اگر بخواهید از این کتابخانه در پروژه لاراولی خود استفاده کنید، باید این پکیج را درون پروژه خود اضافه کنید. برای این کار دستور زیر را وارد کنید. البته در صورتی که قصد دارید از این پکیج در پروژه‌های غیر لاراولی استفاده کنید، می‌توانید این مرحله را نادیده بگیرید.

// config/app.php
'providers' => [
    ...
    Hekmatinasser\Verta\VertaServiceProvider::class,
],
'alias' => [
    ...
    'Verta' => Hekmatinasser\Verta\Verta::class,
]

use Verta;
// or
use Hekmatinasser\Verta\Verta;

$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');

return Verta::getGregorian(1394,10,4);
 //جواب این دستور به صورت زیر است
 // [2015,12,25]

return Verta::getJalali(2015,12,25); 
 //جواب این دستور به صورت زیر است 
 // [1394,10,4]

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

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

دومین روش استفاده از کتابخانه Jdf است. Jdf کتابخانه ای برای تبدیل تاریخ شمسی و میلادی به یکدیگر است که برای زبان‌های برنامه نویسی مختلف توسعه داده شده است. استفاده از این روش نسبت به روش قبل از مزیت‌های کمتری برخودار است. زیرا پکیج ورتا امکانات بسیار زیادی را برای کار با تاریخ در اختیار توسعه دهندگان وب قرار می‌دهد. ازطرفی دیگر پکیج ورتا با استفاده از کدنویسی شی گرا پیاده سازی شده است، به همین دلیل می‌تواند به راحتی در هر بخش از کدهای شما استفاده شود. همچنین علاوه بر تمیز شدن کدهای شما، باعث کاهش میزان کدنویسی می‌شود.

بنابراین زمانی که نیاز به استفاده از توابع مختلف کار با تاریخ احساس نمی‌شود، استفاده از کتابخانه Jdf می‌تواند گزینه مناسبی باشد. همچنین اگر پروژه شما به صورت شی گرا پیاده سازی نشده است، استفاده از این روش پیشنهاد نمی‌شود. در این کتابخانه دو تابع gregorian_to_jalali و jalali_to_gregorian از توابع بسیار کاربردی برای تبدیل تاریخ از میلادی (گرگوری) به هجری شمسی (جلالی) و برعکس می‌باشند. توابع مورد استفاده در این کتابخانه برای تبدیل تاریخ میلادی به شمسی با استفاده از PHP در یک فایل تعریف شده اند. پس در هر جایی از که نیاز به تبدیل تاریخ داشته باشید کافی است که ابتدا فایل اصلی کتابخانه را دانلود و سپس در پروژه خود Include کنید. بعد از این کار می‌توانید به راحتی از توابع این کتابخانه در کدهای خود استفاده کنید.

راهنمای تابع gregorian_to_jalali و jalali_to_gregorian

این تابع‌ها دارای 4 پارامتر (آرگومان) بوده و وظیفه اصلی آن ها، تبدیل تایخ هجری شمسی به میلادی و یا برعکس می‌باشد. سه پارمتر اول این توابع حتما باید وارد شوند، اما پارامتر چهارم در آن‌ها اختیاری است. اگر بخواهیم تاریخ میلادی را به شمسی تبدیل کنیم باید از تابع gregorian_to_jalali استفاده کنیم. تاریخی که در این تابع وارد می‌کنیم، حتماً باید میلادی باشد تا در خروجی به هجری شمسی تبدیل گردد. خروجی این تابع در حالت پیشفرض به صورت آرایه است، اما به وسیله پارامتر چهارم می‌توان خروجی را به عبارت (متن-رشته) تبدیل کرد.

همچنین اگر قصد داشته باشیم که تاریخ شمسی را به میلادی تبدیل کنیم، باید از تابع jalali_to_gregorian استفاده کنیم. تاریخی که در این تابع باید وارد شود حتما باید شمسی باشد تا در خروجی به صورت میلادی نمایش داده شود. پارامترهای این توابع مشابه هم هستند و از نظر کارکرد تفاوتی ندارند.

• تابع تبدیل تاریخ میلادی به شمسی :

mixed gregorian_to_jalali( int $year , int $month , int $day [, string $mod = "" ] )

gregorian_to_jalali($g_y,$g_m,$g_d,$mod);

• تابع تبدیل تاریخ  شمسی به میلادی:

([ ""=mixed jalali_to_gregorian( int $year , int $month , int $day [, string $mod

jalali_to_gregorian($j_y,$j_m,$j_d,$mod);

• g_y$ : پارامتر اول ، سال میلادی یا شمسی ( کامل 4 رقمی )
• g_m$ : پارامتر دوم ، ماه میلادی ( 12- 1 )
• g_d$ : پارامتر سوم ، روز میلادی ( 31 - 1 )
• mod$ : پارامتر چهارم ، یک پارامتر اختیاری است. تا زمانی که این پارامتر را وارد نکنید یا خالی بگذارید، خروجی تابع به صورت یک آرایه از سال و ماه و روز هجری شمسی خواهد بود . اما اگر هر مقدار دلخواهی را برای این پارامتر وارد نمایید، نوع خروجی به یک عبارت (متن-رشته) تغییر خواهد کرد که ترکیبی از سال و ماه و روز است و در بین سال و ماه و روز، همان کاراکتری که در این پارامتر وارد نموده بودید، به عنوان جدا کننده قرار می‌گیرد. به مثال توجّه بفرمایید:

include jdf.php;
gregorian_to_jalali(2011,2,11);//  array(1389,11,22);
gregorian_to_jalali(2011,2,11,' / ');//  1389 / 11 / 22

• j_y$ : پارامتر اول ، سال هجری شمسی ( کامل 4 رقمی )
• j_m$ : پارامتر دوم ، ماه هجری شمسی ( 12- 1 )
• j_d$ : پارامتر سوم ، روز هجری شمسی ( 31 - 1 )
• mod$ : پارامتر چهارم ، یک پارامتر اختیاری است. تا زمانی که این پارامتر را وارد نکنید یا خالی بگذارید، خروجی تابع به صورت یک آرایه از سال و ماه و روز میلادی خواهد بود . اما اگر هر مقدار دلخواهی را برای این پارامتر وارد نمایید، نوع خروجی به یک عبارت (متن-رشته) تغییر خواهد کرد که ترکیبی از سال و ماه و روز است و در بین سال و ماه و روز، همان کاراکتری که در این پارامتر وارد نموده بودید، به عنوان جدا کننده قرار می‌گیرد. به مثال توجّه بفرمایید:

include jdf.php;
jalali_to_gregorian(1389,11,22);//  array(2011,2,11);
jalali_to_gregorian(1389,11,22,' - ');//  2011 - 2 - 11