ForHosting KIT · أدوات المطورين

حساب الوقت المحلي من إزاحة UTC

تحوّل حاسبة الوقت المحلي من إزاحة UTC وقتاً مرجعياً معروفاً بالتوقيت العالمي إلى وقت الساعة المحلي في مدينة عندما تكون إزاحتها الثابتة معلومة لديكم.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا وقت UTC واسم المدينة ومكوّني الساعات والدقائق مع الإشارة. تعرض النتيجة الوقت المحلي وتبيّن ما إذا كان يقع في اليوم السابق أو اليوم نفسه أو اليوم التالي. لا يؤثر في الحساب أي بحث عن منطقة زمنية أو اتصال بالشبكة أو ساعة النظام أو افتراض متعلق بالتوقيت الصيفي، ولذلك تعطي المدخلات نفسها النتيجة نفسها دائماً.

أدخلوا وقت UTC المرجعي واسم المدينة

ابدؤوا بوقت معبّر عنه بالتوقيت العالمي المنسق واكتبوه بدقة بصيغة 24 ساعة HH:MM. منتصف الليل هو 00:00، والظهر هو 12:00، وآخر دقيقة صالحة هي 23:59. حقل المدينة تسمية تعريفية للنتيجة، وليس طلباً للبحث الجغرافي. فإدخال Kathmandu مثلاً لا يجعل الحاسبة تستعلم من خدمة للمناطق الزمنية أو تقرر الإزاحة السارية حالياً. يجب أن تزودوا الحاسبة بالإزاحة المناسبة للتاريخ والظروف. هذا الفصل مهم لأن بعض المدن تطبق التوقيت الصيفي، وقد تغيّر الحكومات قواعد الوقت المدني، كما قد تختلف الإزاحات التاريخية عن القيم الحالية. ارجعوا إلى مصدر موثوق لتحديد الإزاحة السارية أولاً، ثم أدخلوها مع وقت UTC. تمنع الصيغة الصارمة قيماً ملتبسة، بينما تجعل تسمية المدينة الناتج واضحاً عند عرضه في الجداول والتقارير ولوحات المعلومات، من دون الإيحاء بأن الموقع أو قواعده الزمنية قد جرى التحقق منهما آلياً.

حددوا مكوّني إزاحة UTC مع الإشارة

أدخلوا جزء الساعات الصحيحة في offset_hours والدقائق المتبقية في offset_minutes. تصف القيم الموجبة ساعة متقدمة على UTC، وتصف القيم السالبة ساعة متأخرة عنه. تمثل الإزاحة +05:45 بالقيمتين 5 ساعات و45 دقيقة، وتمثل -03:30 بالقيمتين -3 ساعات و-30 دقيقة. يجب أن يحمل المكوّنان غير الصفريين الإشارة نفسها حتى يكون الاتجاه واضحاً. ولإزاحة سالبة تقل عن ساعة، استخدموا صفراً للساعات وقيمة سالبة للدقائق. يمتد المجال الإجمالي المقبول من -12:00 إلى +14:00. يجب أن تكون الدقائق عدداً صحيحاً بين -59 و59؛ فلا تقرّب الحاسبة الكسور ولا تنقل القيم الزائدة ضمناً. بعد التحقق، تحول الحاسبة الإزاحة الكاملة إلى دقائق ذات إشارة وتضيفها إلى عدد الدقائق المنقضية منذ منتصف الليل وفق UTC. تدعم هذه الطريقة إزاحات نصف الساعة وربع الساعة من دون استعمال ساعات عشرية قد تفقد الدقة.

اقرؤوا الوقت المحلي وانتقال اليوم

يحتوي الحقل local_time على الوقت المحوّل بصيغة 24 ساعة HH:MM مع الأصفار البادئة. يوضح day_offset علاقة اليوم المحلي بيوم مرجع UTC: تعني -1 اليوم السابق، وتعني 0 اليوم نفسه، وتعني 1 اليوم التالي. قد تتجاوز إزاحة موجبة مضافة في آخر اليوم منتصف الليل، وقد تعيد إزاحة سالبة بعد منتصف ليل UTC بقليل النتيجة إلى اليوم السابق. لا تستقبل الحاسبة تاريخاً، لذلك لا تفترض شهراً أو يوم أسبوع أو تاريخاً جديداً؛ ويمكنكم تطبيق day_offset على التاريخ المعلوم بأداة تقويم مناسبة. تحتفظ الاستجابة بالمدينة والوقتين ومكوّني الإزاحة كي يبقى الحساب قابلاً للمراجعة. تستعمل الخوارزمية أعداداً صحيحة محدودة فقط، ولا تعتمد على إعدادات اللغة أو منطقة الجهاز الزمنية أو الوقت الحالي. تؤدي المدخلات غير الصالحة إلى خطأ محدد النوع. تبلغ كلفة استعمال API مقدار $0.002 لكل طلب، ويمكن تشغيل المنطق الحتمي نفسه في المتصفح.

حالات الاستخدام

إعداد اجتماع عن بعد

حوّلوا موعد اجتماع متفقاً عليه بتوقيت UTC إلى ساعة مدينة أحد المشاركين عندما تكون الإزاحة السارية معلومة.

إنشاء برنامج رحلة

اعرضوا وقت الوجهة واحتفظوا بمؤشر انتقال اليوم ضمن جدول مبني من سجلات UTC.

توحيد لوحات التشغيل

حوّلوا أوقات أحداث UTC إلى عروض لمدن ذات إزاحة ثابتة من دون الاعتماد على منطقة الخادم الزمنية.

الأسئلة الشائعة

هل تعثر الحاسبة على إزاحة UTC الحالية للمدينة؟

لا. أنتم تقدمون الإزاحة، ويستعمل اسم المدينة كتسمية وصفية للنتيجة فقط.

هل تراعي الحاسبة التوقيت الصيفي؟

لا. أدخلوا الإزاحة الثابتة السارية للمكان والتاريخ بعد مراعاة أي قواعد موسمية.

كيف تدخلون الإزاحة UTC-03:30؟

استخدموا -3 في offset_hours و-30 في offset_minutes لكي يشير المكوّنان إلى التأخر عن UTC.

ماذا يعني day_offset؟

تدل -1 على اليوم السابق، و0 على اليوم نفسه، و1 على اليوم التالي بالنسبة إلى مرجع UTC.

ما كلفة طلب API واحد؟

تبلغ كلفة كل طلب API مقدار $0.002. ويمكن أيضاً تشغيل الحساب الحتمي مباشرة في المتصفح.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/date/local-time-from-offset

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/date/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/local-time-from-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.local_time_from_offset",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←