تاریخ جلالی و نمایش ساعت

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

  • وب سرویس تاریخ متنی دارای 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>