- وب سرویس تاریخ متنی دارای 4 مقدار ورودی یا پارامتر است که جدول آن در زیر آورده شده است.
- تنها پارامتر date الزامی است، سایر پارامترها اختیاری اند و در صورت وارد نشدن یا خالی گذاشتن، مقدار پیشفرض برایشان درنظر گرفته خواهد شد.
پارامترها |
توضیحات |
مقدار پیشفرض |
Date |
قالب نمایشی اطلاعات خروجی |
- |
Timestamp |
برچسب زمانی دلخواه |
time now (زمان فعلی) |
Timezone |
منطقه زمانی جهت محاسبه اختلاف ساعت |
Asia/Tehran |
Language |
زبان خروجی ، fa یا en |
fa |
Id |
کد دلخواه شما برای ابزار |
code101 |
- در حالت کلی برای نمایش تاریخ شمسی مانند کد زیر نوشته می شود.
<div id="code101"><h3><a href="//www.abzarsaz.com" title="دریافت کد نمایش تاریخ خورشیدی و ساعت">ابزار تاریخ شمسی و ساعت</a></h3></div>
<script type="text/javascript" src="//jalali.abzarsaz.com/fa/v2/js/pro.js"></script>
<script type="text/javascript">
var _tJalaliDate = "M";
var _tJalaliTimestamp = "now";
var _tJalaliTimezone = "Asia/Tehran";
var _tJalaliLanguage = "fa";
var _tJalaliId = "code101";
_tJalaliPro (_tJalaliDate,_tJalaliTimestamp,_tJalaliTimezone,_tJalaliLanguage,_tJalaliId);
</script>
- اگر در سایت خود از چند ابزار تاریخ استفاده میکنید به هر کدام یک
Id
اختصاصی دهید تا ابزارها باهم تداخل نداشته باشند، دقت کنید Id
انتخابی شما در 2 جا از اسکریپت باید آورده شود.
- شما می توانید با استفاده از جدول زیر، بجای
M
از کاراکترهای دیگر استفاده کنید و تاریخ دلخواه خود را طراحی نمایید.
- با توجه به جدول زیر، خروجی اسکریپت مربوطه با کاراکتر
M
« نام ماه از سال » را نمایش می دهد.
کاراکتر |
توضیحات |
مثال |
a |
اوقات روز - به صورت خلاصه |
ق.ظ یا ب.ظ |
A |
اوقات روز - کامل |
قبل از ظهر |
b |
ابتدای درشت نمایی |
<strong> |
B |
انتهای درشت نمایی |
</strong> |
d |
شماره روز از ماه - ۲ رقمی |
۰۱ |
f |
شماره فصل (ربع) از سال |
۴ |
F |
نام فصل با حروف فارسی |
زمستان |
g |
ساعت در روز ۱۲ساعته - ۱ رقمی |
۷ |
h |
ساعت در روز ۱۲ساعته - ۲ رقمی |
۰۷ |
G |
ساعت در روز ۲۴ساعته - ۱ رقمی |
۱۹ |
H |
ساعت در روز ۲۴ساعته - ۲ رقمی |
۱۹ |
i |
دقیقه در ساعت - ۲ رقمی |
۰۱ |
j |
شماره روز از ماه - ۱ رقمی |
۲ |
J |
شماره ی روز از ماه به حروف |
دو |
k |
در صد باقیمانده از سال |
۳۲٫۶ |
K |
در صد گذشته از سال |
۶۷٫۴ |
l |
نام روز در هفته |
شنبه |
L |
عدد روز در هفته |
۷ = جمعه |
m |
شماره ماه از سال - ۲ رقمی |
۰۹ |
M |
نام ماه از سال |
دی |
n |
شماره ماه از سال - ۱ رقمی |
۹ |
N |
رفتن به سطر جدید |
<br> |
p |
نام باستانی برج ها |
حوت |
P |
اختلاف ساعت جهانی |
+۰۳:۳۰ |
s |
شماره ثانیه در دقیقه - ۲ رقمی |
۰۹ |
t |
تعداد روزهای (همان) ماه |
۳۰ |
v |
سال به حروف - خلاصه ی دو رقمی |
نود و یک |
V |
سال به حروف |
هزار و سیصد و نود و یک |
W |
شماره این هفته در سال - ۲رقمی |
۴۳ |
y |
سال (به عدد) - ۲ رقمی |
۹۱ |
Y |
سال (به عدد) - ۴ رقمی |
۱۳۹۱ |
z |
تعداد روز (کامل) گذشته از سال |
۲۴۷ |
Z |
تعداد روز (کامل) باقی مانده از سال |
۱۱۸ |
- برای ترکیب دو یا چند کاراکتر کافیست به ترتیب اولویت نمایش آن ها را اضافه کنیم. بنابر این نیازی نیست که از چند اسکریپت (کد) استفاده کنیم و می توان تمام خروجی ها را در یک قالب نمایش داد.
- برای نمایش چند تاریخ در مکان های مختلف، کافیست آن ها را با کاراکتر
^
از هم جدا کنید، سپس آنها به ترتیب شماره کلاس tJalaliClass1 و tJalaliClass2 .. نمایش داده خواهند شد.
- برای استفاده از حروف فارسی و یا کاراکتر هایی مثل کاما '،' اسلش '/' و.. کافیست آن را میان کاراکترهای date بیاوریم.
- در ورودی کاراکتر، بزرگی و کوچکی حروف، اهمیت دارد. برای مثال کاراکتر (حرف) z کوچک برای نمایش تعداد « روزهای گذشته از سال » و Z بزرگ برای نمایش تعداد « روزهای باقیمانده از سال » است.
- خروجی تابع به وقت تهران است و اختلاف زمانی نیمه ی اول و دوم سال، به صورت خودکار در خروجی اعمال می گردد.
- توجه داشته باشید که برای نمایش صحیح حروف فارسی، بهتر است صفحات مورد نظر به صورت UTF-8 باشند.
- برای نمایش اندازه فونت و رنگ خروجی می توانید از style قالب وبلاگتان استفاده کنید، به مثال های زیر توجه کنید.
<!-- کد زیر اختیاری و برای طراحی قالب توسط کاربر می باشد -->
<style>
@font-face {font-family:'Yekan';font-style:normal;font-weight:normal;src:url('https://www.abzarsaz.com/fonts/yekan/yekan-regular.eot') format('embedded-opentype'),url('https://www.abzarsaz.com/fonts/yekan/yekan-regular.woff') format('woff'),url('https://www.abzarsaz.com/fonts/yekan/yekan-regular.ttf') format('truetype')}
.toolsir-jalali2 {font-family:Yekan,Tahoma;font-size:14px;background-color:#FCFCCA;border:1px solid #CAE09D;direction:rtl;width:-moz-max-content;width:max-content;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}
.toolsir-jalali2 a {text-decoration:none;color:#333333}
.toolsir-jalali2 .tJalaliClass1 {text-align:center;padding:1px 5px}
</style>
<!-- ساختار کد زیر الزامی است -->
<!-- کد زیر قالب نمایش است -->
<div id="jalali2" class="toolsir-jalali2"><h3><a href="//www.abzarsaz.com" title="دریافت کد نمایش تاریخ خورشیدی و ساعت">ابزار تاریخ شمسی و ساعت</a></h3>
<!-- خروجی امروز بوقت برلین l، j M Y ساعت H:i می باشد. در کلاس tJalaliClass1 قرار خواهد گرفت -->
</div>
<!-- کد زیر دستورات خروجی برای نمایش است -->
<script type="text/javascript" src="//jalali.abzarsaz.com/fa/v2/js/pro.js"></script>
<script type="text/javascript">
var _tJalaliDate = "امروز بوقت برلین l، j M Y ساعت H:i می باشد."; // در اینجا یک خروجی با چند کاراکتر خواهیم داشت
var _tJalaliTimestamp = "now";
var _tJalaliTimezone = "Europe/Berlin";
var _tJalaliLanguage = "fa";
var _tJalaliId = "jalali2";
_tJalaliPro (_tJalaliDate,_tJalaliTimestamp,_tJalaliTimezone,_tJalaliLanguage,_tJalaliId);
</script>
<!-- کد زیر اختیاری و برای طراحی قالب توسط کاربر می باشد -->
<style>
.toolsir-jalali3 {font:bold 8pt Tahoma;background:url('https://www.abzarsaz.com/images/jalali/ghahvei.png') no-repeat;width:70px;height:80px;text-align:center;border:none}
.toolsir-jalali3 a {text-decoration:none;color:#000}
.toolsir-jalali3 a .tJalaliClass1 {color:#fff}
.toolsir-jalali3 .tJalaliClass1 {padding:6px}
.toolsir-jalali3 .tJalaliClass2 {font-size:15pt;padding:1px;text-decoration:underline}
</style>
<!-- ساختار کد زیر الزامی است -->
<!-- کد زیر قالب نمایش است -->
<div id="3" class="toolsir-jalali3"><h3><a href="//www.abzarsaz.com" title="دریافت کد نمایش تاریخ خورشیدی و ساعت">ابزار تاریخ شمسی و ساعت</a></h3>
<!-- خروجی کاراکتر l در کلاس tJalaliClass1 قرار خواهد گرفت -->
<!-- خروجی کاراکتر j در کلاس tJalaliClass2 قرار خواهد گرفت -->
<!-- خروجی کاراکترهای MNY در کلاس tJalaliClass3 قرار خواهد گرفت که در اینجا طراح برای کلاس tJalaliClass3 قالبی درنظر نگرفته است -->
</div>
<!-- کد زیر دستورات خروجی برای نمایش است -->
<script type="text/javascript" src="//jalali.abzarsaz.com/fa/v2/js/pro.js"></script>
<script type="text/javascript">
var _tJalaliDate = "l^j^MNY"; // در اینجا با یک اسکریپت 3 خروجی خواهیم داشت
var _tJalaliTimestamp = "1339668590";
var _tJalaliTimezone = "Asia/Tehran";
var _tJalaliLanguage = "en";
var _tJalaliId = "3";
_tJalaliPro (_tJalaliDate,_tJalaliTimestamp,_tJalaliTimezone,_tJalaliLanguage,_tJalaliId);
</script>