1- چه در نام توابع و چه در کاراکترهای ورودی ، بزرگی و کوچکی حروف ، اهمّیّت دارد. مثلاً اگر نام تابع jdate را به
صورت JDATE و یا حتّی jDate بنویسید ، عمل نخواهد کرد. در کاراکترها نیز به همین صورت است و حتّی بعضی از کاراکترها ، در نوع بزرگ و کوچکشان ، خروجی
های متفاوتی دارند. مثلاً در پارامتر اوّل تابع jdate کاراکتر (حرف) 'o' کوچک برای نمایش سال و 'O' بزرگ برای نمایش اختلاف ساعت است. این مسئله در
تمامی توابع ، پارامترها و کاراکترها باید رعایت شود.
2- ترتیب پارمترهای روز و ماه در توابع این نرم افزار ، ممکن است تفاوت داشته باشد. مثلاً در بعضی: سال,ماه,روز و در بعضی: سال,روز,ماه است. در این مورد دقّت نمایید.
3- تغییر ساعت رسمی در نیمه ی اوّل و دوم سال ، به صورت خودکار ، انجام خواهد شد. مثلاً در منطقه ی زمانی کشور جمهوری اسلامی ایران ، ( Asia/Tehran یا Iran ) ، در اوایل فروردین ، 1 ساعت به جلو ( IRDT , +04:30 , 16200 ) و در اواخر شهریور ، 1 ساعت به عقب ( IRST , +03:30 , 12600 ) ، تغییر خواهد یافت. توجّه: بعضی سرورها از تنظیمات استانداردی برخوردار نیستند و ممکن است زمان ایجاد این تغییر ، اندکی زودتر یا دیرتر از موقع باشد.
4- اگر قصد دارید خروجی را در صفحات سایت نمایش دهید ، توجّه داشته باشید که برای نمایش صحیح حروف فارسی ، بهتر است صفحات مورد نظر به صورت UTF-8 باشند : <meta charset="utf-8"/>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
5- اگر قصد استفاده از خروجی ها در محاسبات نرم افزاری را داشتید ، حتماً زبان اعداد خروجی را انگلیسی ('en' در پارامتر پنجم تابع jdate و پارامتر چهارم تابع jgetdate ) تعیین نمایید. اعداد فارسی در محاسبات پی اچ پی شناسایی نمی شوند.
6- اعدادی که در پارامترها وارد می کنید ، به هیچ وجه نباید دارای صفر اضافه در سمت چپ باشند. مثلاً اعداد "020" یا '00056' یا '09' را حتماً به 20 یا 56 یا 9 تبدیل کرده ، سپس در توابع استفاده نمایید. در این مورد می توانید از (int) استفاده کنید:
$a='06';
$b=(int)($a);
این نکته را همیشه و همه جا در نظر داشته باشید. در بسیاری از توابع پی اچ پی ، باید رعایت شود و محدود به توابع مورد نظر ما نیست.
7- اگر قصد ویرایش و هرگونه تغییر در فایل نرم افزار را دارید ، حتماً به نکات زیر توجّه داشته باشید.
الف - به دلیل utf-8 بودن این فایل ، هرگز آن را با نرم افزارهای ویرایش متن ساده مثل نوت پد (Notepad) ویندوز ، ویرایش و ذخیره (Save) نکنید. برای این کار حتماً از ویرایشگرهای حرفه ای که مخصوص صفحات اینترنتی هستند ، استفاده نمایید.
ب - اگر قصد ارائه ی فایل ویرایش شده به دیگران را داشتید ، حتماً در سایت خود و درون فایل ، ذکر کنید که ویرایش شده و با نسخه ی اصلی که از jdf.scr.ir دریافت می گردد ، تفاوت دارد.
پ - اگر عیب یا خطایی را در توابع کشف کرده و قصد اصلاح آن را دارید ، حتماً ما را نیز از آن مطّلع سازید تا در نسخه های بعدی نرم افزار ، اصلاح گردد: http://jdf.scr.ir/n
توابع نرم افزار در محدوده ی زمانی زیر مورد آزمایش قرار گرفته اند:
از برچسب زمان 2147483647- تا 2147483647
از ۱۲۸۰/۰۹/۲۴ تا ۱۴۱۶/۱۰/۲۹ ، هجری شمسی
از 15-12-1901 تا 18-01-2038 ، میلادی گرگوری
اگر قبلاً از نرم افزار قدیمی ( jdf.php ، نسخه های کم تر از 2.00 ) استفاده نموده و آن را در سایت خود به کار گرفته اید ، برای کار با نرم افزار جدید ، باید از آخرین تغییرات آن مطّلع شوید و اگر قصد جایگزین نمودن فایل جدید به جای فایل قدیمی را دارید ، حتماً به این تغییرات توجّه فرمایید.
توابع زیر ، در نرم افزار جدید وجود ندارند ، امّا خواص آن ها در توابع دیگر یافت می شود.
تابع jmaketime : نام جدید و استاندارد این تابع
jmktime می باشد و از این پس با این نام از آن استفاده نمایید.
تابع days_of_year : به جای jdate('z',jmktime(12,0,0,$jm,$jd,1)) یا
jdate('z') از days_of_year($jm,$jd,$jy) استفاده کنید.
تابع lastday : به جای
jdate('t',jmktime(12,0,0,$jm,1,$jy)) یا jdate('t') از lastday($jm,$jd,$jy)
استفاده کنید.
تابع is_kabise : به جای jdate('L',jmktime(12,0,0,1,1,$jy)) یا
jdate('L') از is_kabise($jy) استفاده کنید.
تابع Num2Fa یا
Convertnumber2farsi : به جای tr_num($string,'fa') از Num2Fa($srting) استفاده کنید.
تابع
div : به جای (int)($a/$b) از div($a/$b) استفاده کنید.
تابع jtime : به جای time() از jtime() استفاده کنید.
توابع زیر هم ، در نسخه ی اصلی وجود ندارند :
pstrftime , TrimByLength , irtime , short_monthname , monthname , mstart
و در بعضی نسخه های قدیمی ، در ابتدای نام توابع از حرف
p استفاده شده ، امّا اکنون حرف j صحیح است. مثلاً pdate اشتباه بوده و jdate صحیح است.
درضمن ، در نرم افزار جدید ، روز شنبه به عنوان روز اوّل هفته محسوب می گردد و خروجی های مربوطه ، طبق این معیار ، تنظیم خواهند شد.
حالت پیشفرض برای منطقه ی زمانی ، 'Asia/Tehran' ( به وقت جمهوری اسلامی ایران ) و برای زبان اعداد خروجی ، 'fa' ( اعداد فارسی ) می باشد. جهت کسب اطّلاعات بیشتر ، راهنمای توابع را مطالعه فرمایید.
کاراکترهای پارامتر اوّل تابع jdate نیز ، بسیار افزایش یافته و متنوّع تر از نرم افزار قدیمی می باشد. لطفاً جداول مربوطه را مشاهده نمایید.
# آموزش کامل توابع جدید #
jdate jstrftime jmktime jgetdate jcheckdate tr_num آموزش مبتدی از صفر حمایت مالی
# آموزش کامل توابع جدید #
gregorian_to_jalali jalali_to_gregorian jdate_words به کـار گیـری توابع نکات و هشدارها include_once عضویت در کانال ما دریافت (دانلود) فایل و راهنما
نشانی کوتاه این صفحه: