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

حساب الفجوة بين فترتين زمنيتين بتوقيت UTC

تقيس هذه الحاسبة الزمن المنقضي الذي يفصل بين فترتين صريحتين للتاريخ والوقت بصيغة ISO. أدخل بداية كل فترة ونهايتها مع UTC أو إزاحة رقمية، وستُوحَّد القيم إلى UTC قبل المقارنة. إذا تداخل النطاقان أو التقيا عند حد واحد، تكون النتيجة صفراً. كما تعرض الحاسبة المللي ثانية والثواني ومدة ISO 8601 والترتيب الزمني للفترتين.

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

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

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

أدخل فترات كاملة مع إزاحات صريحة

قدّم أربع قيم: بداية الفترة الأولى ونهايتها، ثم بداية الفترة الثانية ونهايتها. يجب أن تكون كل قيمة تاريخاً ووقتاً كاملين وفق ISO 8601، مثل <code>2026-07-25T09:00:00Z</code> أو <code>2026-07-25T12:00:00+01:00</code>. تحدد المنطقة الصريحة اللحظة من دون الاعتماد على الإعداد المحلي. يجب ألا تأتي بداية أي فترة بعد نهايتها. تُقبل أجزاء الثانية حتى ثلاث خانات، بينما تُرفض التواريخ وحدها وأسماء المناطق والثواني الكبيسة والإزاحات المحذوفة بدلاً من تخمينها. إذا كان المصدر يحفظ أسماء مناطق، فحوّلها مسبقاً إلى الإزاحة الصحيحة لتاريخ كل طرف.

تعرّف إلى طريقة حساب فجوة UTC

يُحوَّل كل طرف بحسابات التقويم إلى موضع UTC بالمللي ثانية. إذا انتهت الفترة الأولى قبل بداية الثانية، تُطرح نهاية الأولى من بداية الثانية؛ وإذا انعكس الترتيب تنعكس العملية. في سائر الحالات تتلامس الفترتان أو تتداخلان، فتكون الفجوة صفراً. ولذلك فإن 12:00 عند +01:00 هي اللحظة نفسها 11:00Z. تتضمن الاستجابة الفجوة بالمللي ثانية والثواني، ومدة ISO 8601، وعلامة للترتيب. لا تعتمد الطريقة على الساعة الحالية أو الإعدادات المحلية أو الشبكة أو محلل التاريخ في بيئة التشغيل، ولذلك تبقى النتائج حتمية.

استخدم النتيجة بأمان في إجراءات الجدولة

تفيد النتيجة غير السالبة في قياس وقت الخمول بين الحجوزات أو الحوادث أو فترات التشغيل. راجع علامة الترتيب إذا احتجت إلى معرفة الفترة السابقة. تجمع حالة <code>overlap_or_touch</code> التداخل والتلامس عمداً، لأن كليهما لا يترك زمناً بين النطاقين. لقياس مدة التداخل أو ساعات العمل أو التفريق بين التلامس والتقاطع، استخدم حاسبة متخصصة. ينفذ المتصفح المحلل النقي نفسه الذي تنفذه API. تبلغ تكلفة طلب API مقدار $0.002. احتفظ بقيمة المللي ثانية للمقارنات الدقيقة دون الثانية، واستخدم مدة ISO للتبادل أو العرض.

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

التحقق من الهوامش بين الحجوزات

قس وقت الفراغ الدقيق بين الحجوزات بعد توحيد إزاحات المناطق الزمنية الصريحة.

تحليل التسلسل الزمني للأحداث

احسب زمن الصمت بين حادثتين سجلتهما أنظمة تستخدم إزاحات UTC مختلفة.

التحقق من الفصل بين الجداول

تأكد من وجود وقت كافٍ بين نافذتي تشغيل بصرف النظر عن ترتيب الإدخال.

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

ماذا يحدث إذا تداخلت الفترتان؟

تكون الفجوة صفراً والترتيب overlap_or_touch، لأنه لا يوجد زمن يفصل بين النطاقين.

ماذا يحدث إذا انتهت فترة عند بداية الأخرى تماماً؟

تتلامس الفترتان، ولذلك تكون الفجوة المعادة صفراً بالضبط.

هل تدعم الحاسبة إزاحات زمنية مختلفة؟

نعم. يُوحَّد كل طرف من Z أو إزاحته الرقمية الصريحة إلى UTC قبل المقارنة.

هل يمكن حذف إزاحة المنطقة الزمنية؟

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

ما دقة النتيجة؟

تدعم المدخلات والمخرجات دقة المللي ثانية، وتُعاد الفجوة أيضاً بالثواني وكمدة ISO 8601.

ما تكلفة طلب API؟

السعر الأساسي المنشور هو $0.002 لكل طلب، والحساب الحتمي نفسه متاح في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/intervals-gap

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

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

curl -X POST https://api.kit.forhosting.com/date/intervals-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}'

const res = await fetch("https://api.kit.forhosting.com/date/intervals-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "first_start": "2026-07-25T09:00:00Z",
    "first_end": "2026-07-25T10:30:00Z",
    "second_start": "2026-07-25T12:00:00+01:00",
    "second_end": "2026-07-25T13:00:00+01:00"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/intervals-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "first_start": "2026-07-25T09:00:00Z",
    "first_end": "2026-07-25T10:30:00Z",
    "second_start": "2026-07-25T12:00:00+01:00",
    "second_end": "2026-07-25T13:00:00+01:00"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/intervals-gap", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"first_start":"2026-07-25T09:00:00Z","first_end":"2026-07-25T10:30:00Z","second_start":"2026-07-25T12:00:00+01:00","second_end":"2026-07-25T13:00:00+01:00"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/intervals-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "first_start": "2026-07-25T09:00:00Z",
  "first_end": "2026-07-25T10:30:00Z",
  "second_start": "2026-07-25T12:00:00+01:00",
  "second_end": "2026-07-25T13:00:00+01:00"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_chars 35

الأخطاء

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

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