بازگشت به فهرست

سرویس‌های جانبی هُما

تاریخ و ساعت آنلاین

معرفی و شروع سریع

سرویس تاریخ و ساعت آنلاین هُما یک ابزار عمومی و بدون احراز هویت است که زمان هم‌اکنون را در قالب 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 دارند و قابل فراخوانی بین‌دامنه‌ای هستند.