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

کتابخانه jdf یکی از کتابخانه های رایگان و کاربردی برای کار با تاریخ شمسی در PHP است. با ما همراه باشید تا با تبدیل تاریخ شمسی به میلادی با jdf آشنا شویم.

آشنایی با کتابخانه jdf در PHP

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

جهت شروع کار با کتابخانه jdf ابتدا می بایست آن را ضمیمه برنامه خود کنیم. با استفاده از دستور require_once بصورت زیر می توانیم این کار را انجام دهیم:

1

2

3

4

5

<?php

require_once 'jdf.php';

?>

آشنایی با تابع ()jdate

تابع ()jdate مهمترین تابع موجود در کتابخانه jdf است. قالب کلی این تابع بصورت زیر است:

;(jdate(format, timestamp, none, time_zone, num_lang

از میان این پارامترها تنها استفاده از پارامتر format اجباری است. پارامترهای دوم به بعد اختیاری بوده و مقادیر پیش فرض زیر به جای آنها قرار می گیرد:

;(‘jdate(format, time(), none, ‘Asia/Tehran’, ‘fa

پارامتر دوم (timestamp) اگر استفاده نشود، به این معنی است که از timestamp زمان جاری (معادل تابع ()time) در پردازش تاریخ استفاده خواهد شد. پارامتر سوم تابع بلااستفاده است و ما هم از آن استفاده نخواهیم کرد. پارامتر چهارم (time_zone) منطقه زمانی موردنظر را مشخص میکند که مقدار پیش فرض آن ‘Asia/Tehran’ است. پارامتر آخر (num_lang) زبان اعداد مورد استفاده را مشخص می کند و مقدار پیش فرض آن ‘fa’ است (fa برای فارسی و en برای انگلیسی).

نمایش تاریخ شمسی به فرمت های مختلف

در قطعه کد زیر تنها از پارامتر اول (format) در تابع ()jdate استفاده کرده ایم. در نتیجه بقیه پارامترها با مقادیر پیش فرضشان جایگزین خواهند شد.

1

2

3

4

5

6

7

8

9

<?php

echo jdate('Y/m/d');

echo jdate('y/m/d');

echo jdate('y/n/j');

?>

در قطعه کد فوق تاریخ جاری شمسی را به سه شکل مختلف بدست آورده و نمایش داده ایم. حرف Y (در خط ۳) شماره سال شمسی را بصورت چهار رقمی بدست می آورد. حروف m و d نیز به ترتیب معرف شماره ماه و روز جاری هستند. به کوچک و بزرگ بودن حروف دقت داشته باشید. (مانند جلسه قبل)

در خط ۵ شماره سال را بصورت دو رقمی نمایش داده ایم (با استفاده از حرف y). در خط ۷ نیز شماره ماه (با حرف n) و شماره روز (با حرف j) را بصورت عدد تک رقمی در خروجی چاپ کرده ایم (حروف m و d اینکار را بصورت دورقمی انجام می دهند).

خروجی قطعه کد فوق به صورت زیر است :

1

2

3

۱۳۹۸/۰۸/۰۴

۹۸/۰۸/۰۴

۹۸/۸/۴

منبع: https://mzsoftware.ir/working-with-jalali-date-in-php/