atVSG

0011001000110100

وحید امیری مطلق

توسعه دهنده وب و موبایل

معرفی کلاس های jDateTimePlus و EasyDateTime برای PHP


jDateTimePlus

کلاس jDateTimePlus بر پایه ی نسخه 2.2.0 کلاس jDateTime هست. هدف از نوشتنش برطرف کردن بعضی مشکلات کلاس قبلی و به روز کردن الگوریتم توابع تبدیل شمسی به میلادی و میلادی به شمسی با استفاده از توابع jdf 2.60 بود. کلاس jDateTime توسط سالار کابلی ساخته شده. انصافا کار خوبی کرده و مستندات خوبی هم داره به خاطر همین دیگه من تکرار مکررات نمیکنم و برای نحوه ی استفاده میتونید مستندات سالار رو در وبلاگش بخونید.

صفحه jDateTimePlus در گیت هاب + راهنمای نصب و استفاده

اما برسیم به اصل مطلب. کلاس EasyDateTime!

 

EasyDateTime

 

EasyDateTime در واقع یک کلاس سطح بالا برای مخفی کردن اون پیچیدگی هایی از کلاس jDateTimePlus هست که عملا برای کاربر نهایی استفاده کننده گیج کننده هستن و غیر ضروری. این یک کلاس آماده برای ورورد و استفاده سریع و راحت در اپ های واقعیه. تعداد زیادی از متود های jDateTimePlus پارامتر Timezone رو دریافت میکنن که این کار کاملا بیهوده هست و نیازی بهش نیست. خیلی از متود ها هم تعریف دقیقی از کارکردشون در دنیای واقعی (!) ارائه نمیکنن و مثلا به ندرت به طور مستقیم مورد استفاده قرار میگیرن. این کلاس علاوه بر موارد قبلی، ظاهر بسیار تمیزی داره و همچنین یکی دو متود جدید هم معرفی میکنه که کاملا کاربردی هستن. (تبدیل DateTime شمسی به میلادی و فرمت اون، تبدیل Timezone ها به یکدیگر)

صفحه ی EasyDateTime در گیت هاب + راهنمای نصب و استفاده

توضیحات در ادامه مطلب.

 

یکی از اهداف اصلی در طراحی این کلاس، سادگی کار باهاش بود که میتونم بگم به این هدف رسیدم. کافیه یک object از این کلاس بسازید و دو پارامتر Timezone و نوع تقویم (میلادی یا شمسی) رو پاس کنید تا آماده استفاده از تمام متود ها بشید.

نکته مهم

به طور پیش فرض این کلاس برای تمام تاریخ های ورودی، Timezone پیش فرض رو UTC/GMT فرض میکنه. بنابراین موقع استفاده از متود ها سعی میکنه زمان ها رو به اون تایم زونی که شما در constructor پاس کردید، تبدیل کنه. اگه نمیخواید تاریخ وروردی تبدیل بشه پس موقع ساخت شی از کلاس، به constructor برای پارامتر Timezone، مقدار ‘UTC’ رو پاس کنید.

سعی کردم مثال های زیادی برای استفاده از این کلاس بنویسم. میتونید اون ها رو در مخزن پروژه پیدا کنید.

 

استفاده از مثال ها:

دو راه برای دیدن مثال ها هست:

  • باید فایل examples.php رو اجرا کنند. برای این کار مسلما احتیاج به یک web server دارید. میتونید از web server داخلی php هم استفاده کنید. برای این کار در روت پروژه دستور زیر رو در cmd یا bash یا terminal اجرا کنید:
php -S localhost:8000
  • فایل examples-compiled.html رو با مرورگرتون باز کنید. (این فایل فقط html هست و نمیتونید توش تمرین کنید)


 برچسب ها: ، ، ، ، ، ، ، ، ، ، ،

 دیدگاه ها:
سوال یا دیدگاه؟

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *