تقویم و تاریخ هجری شمسی (خورشیدی) یکی از دقیق ترین شیوه های گاهشماری در جهان به حساب می آید که خوشبختانه هم اکنون در جمهوری اسلامی ایران به رسمیت شناخته شده و استفاده می شود.
اما متاسفانه در فضای مجازی نمی توان به راحتی به گاهشماری هجری شمسی دست یافت و از آن در ساختار وب سایت ها استفاده نمود. البته تاکنون نرم افزارهایی در این زمینه ارائه گردیده، اما تنها نحوه نمایش محدودی داشته اند و کاربر نمی توانست با سلیقه نیاز خود ابزار تاریخ شمسی را نمایش دهد. هم اکنون خرسندیم که توانسته ایم این ابزار را با انعطاف پذیری بالا طراحی کنیم و امیدواریم شما نیز ما را در این راه حمایت کنید.
نکات مهم:
در نام کاراکترهای ورودی، بزرگی و کوچکی حروف، اهمیت دارد. مثلاً در کاراکتر (حرف) 'z' کوچک برای نمایش تعداد روزهای گذشته از سال و 'Z' بزرگ برای نمایش تعداد روزهای باقیمانده از سال است.
تغییر ساعت رسمی در نیمه ی اول و دوم سال، به صورت خودکار، انجام خواهد شد.
توجه داشته باشید که برای نمایش صحیح حروف فارسی، بهتر است صفحات مورد نظر به صورت UTF-8 باشند.
اگر قصد استفاده از خروجی ها در محاسبات نرم افزاری را داشتید، حتماً زبان اعداد خروجی را انگلیسی (lang=en) نمایید. اعداد فارسی در محاسبات شناسایی نمی شوند.
برای نمایش اندازه فونت و رنگ خروجی می توانید از style قالب وبلاگتان استفاده کنید، در صورتی که تجربه کدنویسی html را ندارید از پشتیبان قالب تان کمک بگیرید.
خروجی تابع به وقت
تهران است و اختلاف زمانی، به صورت خودکار در خروجی اعمال می گردد. اما اگر قصد تغییر آن را دارید، فهرست مناطق زمانی را می توانید در نشانی
http://php.net/manual/en/timezones.php مشاهده نموده و منطقه مورد نظر خود را در این پارامتر، وارد کنید.
پارامترها |
توضیحات |
مقدار پیشفرض |
timestamp |
برچسب زمانی دلخواه |
time() = زمان فعلی |
zone |
منطقه زمانی جهت محاسبه اختلاف ساعت |
Asia/Tehran |
lang |
زبان اعداد خروجی ، fa یا en |
fa |
date |
قالب نمایشی اطلاعات خروجی |
'' |
ابزار دارای 4 ورودی یا پارامتر است که فقط پارامتر آخر آن '
date' الزامی است، سایر پارامترها اختیاری اند و در صورت وارد نشدن یا خالی '' گذاشتن، مقدار پیشفرض برایشان وارد می شود. در ادامه جدول کاراکترهای پارامتر
date را آورده ایم.
کاراکتر |
کاربرد کاراکتر date |
مثال |
a |
اوقات روز - به صورت خلاصه |
ق.ظ یا ب.ظ |
A |
اوقات روز - کامل |
قبل از ظهر |
b |
ابتدای درشت نمایی |
< b > |
B |
انتهای درشت نمایی |
< /b > |
d |
شماره روز از ماه - ۲ رقمی |
۰۱ |
f |
شماره فصل (ربع) از سال |
۴ |
F |
نام فصل با حروف فارسی |
زمستان |
g |
ساعت در روز ۱۲ساعته - ۱ رقمی |
۷ |
G |
ساعت در روز ۲۴ساعته - ۱ رقمی |
۱۹ |
h |
ساعت در روز ۱۲ساعته - ۲ رقمی |
۰۷ |
H |
ساعت در روز ۲۴ساعته - ۲ رقمی |
۱۹ |
i |
دقیقه در ساعت - ۲ رقمی |
۰۱ |
j |
شماره روز از ماه - ۱ رقمی |
۲ |
J |
شماره ی روز از ماه به حروف |
دو |
k |
در صد باقیمانده از سال |
۳۲٫۶ |
K |
در صد گذشته از سال |
۶۷٫۴ |
l |
نام روز در هفته - کامل |
شنبه |
L |
عدد روز در هفته |
۷ = شنبه |
m |
شماره ماه از سال - ۲ رقمی |
۰۹ |
M |
نام ماه از سال - کامل |
دی |
n |
شماره ماه از سال - ۱ رقمی |
۹ |
N |
رفتن به سطر جدید |
< br > |
p |
نام باستانی برج ها |
حوت |
P |
اختلاف ساعت جهانی |
+۰۳:۳۰ |
s |
شماره ثانیه در دقیقه - ۲ رقمی |
۰۹ |
t |
تعداد روزهای (همان) ماه |
۳۰ |
v |
سال به حروف - خلاصه ی دو رقمی |
نود و یک |
V |
سال به حروف - کامل |
هزار و سیصد و نود و یک |
W |
شماره این هفته در سال - ۲رقم |
۴۳ |
y |
سال (به عدد) دو رقمی |
۹۱ |
Y |
سال (به عدد) چهار رقمی |
۱۳۹۱ |
z |
تعداد روز (کامل) گذشته از سال |
۲۴۷ |
Z |
تعداد روز (کامل) باقی مانده از سال |
۱۱۸ |
آموزش استفاده
در حالت کلی: http://jalali.toolsir.com/date.class.php?timestamp=&zone=Asia/Tehran&lang=fa&date=Y
برای استفاده از ابزار می توانید 4 پارامتر ورودی را با توجه به جدول داده شده انتخاب کنید و از طریق جدول کاراکترها نوع نمایش تاریخ یا ساعت را برای پارامتر date ویرایش کنید.
برای ترکیب دو یا چند کاراکتر کافیست به ترتیب اولویت نمایش آن ها را اضافه کنیم. بنابر این نیازی نیست که از چند اسکریپت استفاده کنیم و می توان تمام خروجی ها را در یک قالب نمایش داد، مانند:
http://jalali.toolsir.com/date.class.php?timestamp=&zone=Asia/Tehran&lang=fa&date=d/m/Y
برای استفاده از حروف فارسی و یا کاراکتر هایی مثل کاما '،' کافیست آن را میان کاراکترهای date بیاوریم.
برای درک بهتر از این ابزار نمونه مثال های زیر را انتخاب کنید سپس دکمه ساخت کد ابزار را کلیک کرده و به ساختار کد نویسی آن ها دقت کنید.