سرویسهای جانبی هُما
تاریخ و ساعت آنلاین
معرفی و شروع سریع
سرویس تاریخ و ساعت آنلاین هُما یک ابزار عمومی و بدون احراز هویت است که زمان هماکنون را در قالب UTC و همچنین نمایش شمسی و میلادی در منطقهٔ زمانی دلخواه برمیگرداند. برای نمایش ساعت روی سایت، هماهنگسازی لاگ و اپلیکیشنها مناسب است.
آدرس سرویس: https://www.homacrm.com/api/v1/tools/datetime
سادهترین نمونه — زمان فعلی به وقت تهران:
https://www.homacrm.com/api/v1/tools/datetime?timezone=Asia/Tehran
زمان همیشه از سامانهٔ هُما محاسبه میشود و پاسخ کش نمیشود؛ بنابراین هر بار مقدار بهروز دریافت میکنید.
پارامترها
timezone— منطقهٔ زمانی به فرمت IANA، مثلAsia/TehranیاEurope/London(پیشفرض: Asia/Tehran)withSeconds— نمایش ثانیه در رشتههای ساعت؛ مقدارfalseثانیه را حذف میکند (پیشفرض: true)
اگر timezone نامعتبر باشد، سرویس خطای ۴۰۰ برمیگرداند. از شناسههای معتبر IANA استفاده کنید.
ساختار پاسخ
پاسخ یک شیء JSON است؛ نمونهٔ خروجی:
{
"success": true,
"data": {
"utcIso": "2025-06-30T08:20:15.000Z",
"unixMs": 1751271615000,
"timezone": "Asia/Tehran",
"gregorian": { "date": "2025-06-30", "time": "11:50:15", "weekday": "Monday" },
"jalali": { "date": "1404/04/09", "time": "11:50:15", "weekday": "دوشنبه", "monthName": "تیر" },
"serverSource": "sql"
}
}
utcIso— لحظهٔ مرجع بهصورت ISO 8601 (UTC)unixMs— همان لحظه بر حسب میلیثانیهٔ یونیکسgregorian/jalali— تاریخ، ساعت و نام روز/ماه در منطقهٔ زمانی درخواستیserverSource— روش محاسبهٔ زمان در پاسخ (مقدار فنی؛ معمولاًsqlیاnode)
نمونهکد
cURL
curl -L "https://www.homacrm.com/api/v1/tools/datetime?timezone=Asia/Tehran"
JavaScript
const res = await fetch("https://www.homacrm.com/api/v1/tools/datetime?timezone=Asia/Tehran");
const { data } = await res.json();
console.log(data.jalali.date, data.jalali.time); // 1404/04/09 11:50:15
بدون ثانیه
https://www.homacrm.com/api/v1/tools/datetime?timezone=Asia/Tehran&withSeconds=false
هدرهای CORS فعال است؛ سرویس را میتوانید مستقیم از مرورگر و بیندامنهای فراخوانی کنید. پاسخ کش نمیشود تا همیشه زمان دقیق را بگیرید.
نکات
- همهٔ سرویسهای این بخش بدون احراز هویتاند؛ آدرس آنها را در سایت، ایمیل و اپلیکیشن خود استفاده کنید.
- سرویس تولید QR را میتوانید مستقیم در تگ <img> (در src) قرار دهید؛ برای دادههای طولانی مثل کارت ویزیت از POST با بدنهٔ JSON استفاده کنید.
- خروجی QR برای یک روز کش میشود؛ در صورت تغییر محتوا، پارامترها را عوض کنید.
- سرویس تاریخ و ساعت آنلاین کش نمیشود و همیشه زمان بهروز را برمیگرداند؛ برای نمایش تاریخ شمسی روی سایت و اپلیکیشن مناسب است.
- هر دو سرویس هدر CORS دارند و قابل فراخوانی بیندامنهای هستند.