کتابخانه تاریخ شمسی Vajdate
کتابخانه تاریخ شمسی Vajdate یک ابزار قدرتمند و ساده برای تبدیل تاریخ های میلادی به شمسی است که می توانید به صورت رایگان در پروژه های خود استفاده کنید. این کتابخانه علاوه بر تبدیل دقیق تاریخ ها، امکان نمایش آن ها را به صورت شمسی یا میلادی و با فرمت های دلخواه فراهم می کند.
ویژگی های اصلی Vajdate:
- تبدیل تاریخ میلادی به شمسی با دقت بالا.
- پشتیبانی از فرمت های مختلف تاریخ.
- نمایش تاریخ به زبان فارسی یا انگلیسی.
- امکان استفاده از اعداد فارسی برای تاریخ شمسی.
- استفاده ساده در پروژه های PHP.
- این کتابخانه کاملاً رایگان است و برای استفاده شخصی یا تجاری بدون نیاز به مجوز اضافی در دسترس قرار دارد. با استفاده از کتابخانه Vajdate، می توانید با خیال راحت در پروژه های خود از تاریخ شمسی استفاده کنید و نمایش دلخواه خود را اعمال کنید.
نحوه استفاده
برای استفاده از کتابخانه vajdate که در فایل vajdate.php قرار دارد، باید این فایل را در پروژه خود ایمپورت کنید. این کار به شما اجازه می دهد تا از توابع تعریف شده در این کتابخانه به راحتی در صفحات مختلف وب سایت یا پروژه تان استفاده کنید.
روش های ایمپورت کردن vajdate.php:
استفاده از include یا require: یکی از ساده ترین روش ها برای ایمپورت یک فایل PHP، استفاده از دستورات include یا require است. اگر فایل vajdate.php در مسیر پروژه شما قرار دارد، می توانید آن را به صورت زیر ایمپورت کنید:
include ‘vajdate.php’;
تنظیمات اولیه
کتابخانه vajdate به شما این امکان را می دهد که تنظیمات مختلفی مانند منطقه زمانی، نوع نمایش اعداد، و نوع نمایش ماه ها و روزهای هفته را تعیین کنید. برای این کار از تابع setVajdateConfig استفاده کنید:
setVajdateConfig($number = ‘en’, $mon = ‘fa’, $week = ‘fa’, $zone = ‘Asia/Tehran’);
توضیحات پارامترها:
$number: نوع نمایش اعداد. مقادیر ممکن ‘en’ (اعداد انگلیسی) یا ‘fa’ (اعداد فارسی).
$mon: نوع نمایش نام ماه ها. مقادیر ممکن ‘en’ (ماه های میلادی) یا ‘fa’ (ماه های شمسی).
$week: نوع نمایش نام روزهای هفته. مقادیر ممکن ‘en’ (روزهای هفته میلادی) یا ‘fa’ (روزهای هفته شمسی).
$zone: منطقه زمانی. برای مثال، ‘Asia/Tehran’ برای تهران.
پس از تنظیمات، می توانید از تابع vajdate برای دریافت تاریخ با فرمت دلخواه استفاده کنید. تنظیمات اعمال شده به طور خودکار در این تابع لحاظ خواهد شد.
یک نمونه کامل از نمایش تاریخ و ساعت
include ‘vajdate.php’;
setVajdateConfig($number = ‘en’, $mon = ‘fa’, $week = ‘fa’, $zone = ‘Asia/Tehran’);
$customDate = vajdate(‘Y-m-d H:i:s’);
echo $customDate;
که خروجی آن بر فرض مثال میشود:
1403-06-21 18:54:34
تبدیل تاریخ میلادی به شمسی
برای تبدیل تاریخ میلادی به شمسی، از تابع vajdate استفاده کنید. این تابع به شما امکان می دهد تاریخ میلادی را به فرمت شمسی تبدیل کرده و با فرمت دلخواه خود نمایش دهید. به عنوان مثال:
$formattedDate = vajdate(‘Y-m-d’, ‘2024-09-11’);
echo $formattedDate:
:که خروجی آن مانند زیر نمایش داده میشود
1403-06-21
پارامترهای خروجی
| پارامتر | توضیحات |
|---|---|
| Y | نمایش سال شمسی |
| m | نمایش ماه شمسی با دو رقم (01 تا 12) |
| d | نمایش روز ماه با دو رقم (01 تا 31) |
| H | نمایش ساعت (00 تا 23) |
| i | نمایش دقیقه (00 تا 59) |
| s | نمایش ثانیه (00 تا 59) |
| z | نمایش روز هفته (شنبه تا جمعه) |
| x | نمایش نام ماه (فارسی یا انگلیسی بسته به زبان انتخابی) |
نمونه کد و خروجی کتابخانه
| خروجی | کد |
|---|---|
| ۱۴۰۳-۰۶-۱۷ ۱۴:۳۲ – شنبه – مهر | echo vajdate('Y-m-d H:i - z - x'); |
| ۱۴۰۳/۰۶/۱۷ – شنبه – مهر | echo vajdate('Y/m/d - z - x'); |
| ۱۷/۰۶/۱۴۰۳ – مهر | echo vajdate('d/m/Y - x'); |
| ۱۷/۰۶/۱۴۰۳ – شنبه | echo vajdate('d/m/Y - z'); |
| 2024-09-09 14:32 – Sunday – September | echo vajdate('Y-m-d H:i - z - x'); |
| 2024/09/09 – Sunday – September | echo vajdate('Y/m/d - z - x'); |
| 09/09/2024 – September | echo vajdate('d/m/Y - x'); |
| 09/09/2024 – Sunday | echo vajdate('d/m/Y - z'); |
| 2024-09-09 – September – Sunday | echo vajdate('Y-m-d - x - z'); |