تخطي إلى المحتوى
POST AI agent ready /v1/timezone

Timezone API - بحث مجاني عن الوقت الحالي

إرجاع الوقت الحالي وإزاحة UTC والاختصار وحالة التوقيت الصيفي لمنطقة زمنية IANA معينة. الافتراضي هو UTC إذا لم يتم تحديد منطقة زمنية.

Parameters

stringrequired

IANA timezone name (e.g. America/New_York, Europe/London).

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

عرض الساعات المترجمة في لوحة القيادة

أنشئ أداة ساعة متعددة المناطق الزمنية للوحة تحكم الفريق. قم بتسمية نقطة النهاية هذه للمنطقة الزمنية لكل عضو في الفريق (على سبيل المثال أمريكا/نيويورك، أوروبا/برلين، آسيا/طوكيو) واعرض التوقيت المحلي الحالي بجانب اسمه.

جدولة الإخطارات في ساعات العمل المحلية

قبل إرسال إشعار دفع أو بريد إلكتروني، تحقق من المنطقة الزمنية للمستلم للتأكد من أنها تقع بين الساعة 9 صباحًا و6 مساءً بالتوقيت المحلي. قم بتأخير التسليم حتى نافذة العمل التالية لتحسين الأسعار المفتوحة وتجنب الانقطاعات خارج ساعات العمل.

Frequently asked questions

ما هو تنسيق المنطقة الزمنية الذي تقبله نقطة النهاية هذه؟
ويقبل معرفات المنطقة الزمنية IANA مثل America/New_York، أو Europe/London، أو Asia/Tokyo. يتم الاحتفاظ بالقائمة الكاملة على iana.org/time-zones.
هل الاستجابة تراعي التوقيت الصيفي؟
نعم. يشير الحقل is_dst إلى ما إذا كان التوقيت الصيفي نشطًا أم لا، ويعكس الحقل utc_offset الإزاحة الحالية بما في ذلك أي تعديل للتوقيت الصيفي.
ماذا يحدث إذا مررت بمنطقة زمنية غير صالحة؟
ترجع نقطة النهاية خطأ 400 مع رسالة توضح أنه لم يتم التعرف على معرف المنطقة الزمنية.
هل يمكنني استخدام هذا للحصول على وقت UTC الحالي؟
نعم. إما أن تحذف معلمة المنطقة الزمنية (الافتراضيات هي UTC) أو قم بتمرير "UTC" بشكل صريح للحصول على التوقيت العالمي المنسق الحالي.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.