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

حاسبة انتهاء الصندوق الزمني مع فترة فاصلة

لا ينجح الصندوق الزمني إلا عندما تكون نهايته واضحة تماماً. تضيف هذه الحاسبة عدداً ثابتاً من الدقائق إلى وقت بدء بنظام 24 ساعة، ثم تعرض وقت التوقف الدقيق حتى عند الانتقال إلى يوم لاحق.

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

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

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

ويمكنكم أيضاً حجز فترة فاصلة محمية بعد الصندوق كي لا تبدأ الكتلة التالية فوراً. تفصل النتيجة بين وقت العمل ووقت الانتقال، ولذلك تناسب جداول الاجتماعات وجلسات التركيز وورش العمل والمقابلات والخطط التشغيلية.

حددوا وقت توقف واضحاً للجميع

أدخلوا وقت البدء بصيغة HH:MM الصارمة وفق نظام 24 ساعة، وحددوا المدة الثابتة بعدد صحيح من الدقائق. تجري الحاسبة عملية حسابية على الساعة ولا تخمّن انطلاقاً من الوقت الحالي، لذلك تعطي القيم نفسها النتيجة نفسها دائماً. وقت التوقف الحازم هو اللحظة التي ينتهي عندها النشاط المحدد زمنياً، أما الفترة الفاصلة الاختيارية فلا تدخل ضمن مدة ذلك النشاط. لهذا الفرق أثر عملي مهم. فالنقاش الذي يستغرق خمسين دقيقة ويبدأ في 09:35 ينتهي في 10:25، سواء حجزتم عشر دقائق إضافية لتدوين الملاحظات أو تغيير القاعة أو أخذ استراحة قصيرة أم لم تحجزوها. يحول فصل القيمتين دون تحول كتلة معلنة مدتها خمسون دقيقة بصمت إلى التزام مدته ستون دقيقة. تكرر الاستجابة وقت البدء والمدة بعد توحيد الصيغة، وتعرض وقت النهاية وإزاحة اليوم. تعني الإزاحة صفر اليوم التقويمي نفسه، وتعني واحد اليوم التالي، وتتيح القيم الأكبر التعامل مع صناديق زمنية طويلة مقصودة من دون اشتراط تاريخ أو منطقة زمنية.

احجزوا وقتاً للانتقال من دون تغيير الصندوق

استخدموا buffer_minutes عندما ينبغي ألا تبدأ الكتلة المجدولة التالية لحظة الوصول إلى وقت التوقف. تضيف الحاسبة هذه الفترة بعد المدة، ثم تعيد next_block_time بوصفه أبكر بداية محمية للنشاط اللاحق. على سبيل المثال، قد تنتهي ورشة في 16:40 ولا يبدأ الموعد التالي قبل 16:55، فتتوفر خمس عشرة دقيقة للأسئلة أو الترتيب أو الانتقال أو التحضير. يبقى وقت التوقف الأصلي 16:40، وهذا يساعد المسؤول عن الورشة على الالتزام بالمدة الموعودة. إذا كانت الفترة صفراً، تساوى وقت الكتلة التالية مع وقت التوقف. يجب أن تكون القيمة عدداً صحيحاً من الدقائق بين صفر و1,440، وبذلك يمكنكم عدم حجز انتقال مطلقاً أو حماية يوم كامل. تتضمن النتيجة أيضاً next_block_day_offset لأن الجلسة المتأخرة وفترتها الفاصلة قد تتجاوزان منتصف الليل حتى إن لم يتجاوزه الصندوق نفسه. تمنع هذه الإزاحة الصريحة جداول ملتبسة مثل 00:10، إذ لا يوضح الوقت وحده أن القيمة المعروضة تخص يوم الغد.

افهموا عبور منتصف الليل والتحقق من المدخلات

تتكرر أوقات الساعة كل أربع وعشرين ساعة، لكن الزمن المنقضي لا يتكرر. لذلك يرتبط بكل وقت محسوب حقل لإزاحة اليوم. افترضوا أن كتلة تبدأ في 23:30 وتستمر تسعين دقيقة؛ يكون وقت توقفها 01:00 مع إزاحة مقدارها واحد، وليس 01:00 الأسبق في اليوم نفسه. وإذا تبعتها فترة من ثلاثين دقيقة، تصبح أبكر بداية للكتلة التالية 01:30 مع الإزاحة نفسها. قد تنتج المدد الأطول إزاحات تتجاوز واحداً، حتى الحد الأقصى المدعوم وهو 10,080 دقيقة أو سبعة أيام. المدخلات صارمة عمداً لتبقى عمليات تكامل API قابلة للتوقع: يجب أن يحتوي start_time على رقمين للساعة، ثم نقطتين رأسيتين، ثم رقمين للدقائق؛ تتراوح الساعات من 00 إلى 23 والدقائق من 00 إلى 59. ويجب أن تكون المدة والفترة الفاصلة عددين صحيحين محدودين ضمن النطاقين المعلنين. تعيد القيم غير الصالحة خطأ في الإدخال بدلاً من التقريب أو التخمين أو التفسير حسب إعدادات الجهاز المحلية. لا يؤثر التاريخ أو التوقيت الصيفي أو الوقت الحالي أو الاتصال بالشبكة أو أي منطقة زمنية خفية في الحساب.

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

أنشئوا جدول أعمال للاجتماع

حوّلوا كل بند إلى وقت توقف ظاهر، واحتفظوا بانتقال قبل المتحدث أو الجلسة التالية.

خططوا لجلسة تركيز

احسبوا موعد انتهاء العمل العميق، واحجزوا فاصلاً قصيراً للحفظ وتدوين الملاحظات والاستراحة.

جدولوا المقابلات أو الورش

افصلوا الوقت الموعود للمشاركين عن تغيير القاعات والتقييم والترتيب والتحضير.

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

ما المقصود بوقت التوقف الحازم؟

هو وقت البدء مضافاً إليه الزمن الثابت للصندوق. ينبغي أن ينتهي النشاط عند ذلك الوقت.

هل تدخل الفترة الفاصلة ضمن المدة؟

لا. تبدأ بعد وقت التوقف وتؤخر أبكر وقت ينبغي أن تبدأ عنده الكتلة التالية.

ماذا يحدث إذا تجاوزت النتيجة منتصف الليل؟

تنتقل الساعة إلى اليوم التالي وتزداد إزاحة اليوم المعنية، فيظهر الانتقال بوضوح.

هل يمكن إدخال الثواني أو كسور الدقائق؟

لا. تقبل الحاسبة وقت البدء بصيغة HH:MM وأعداداً صحيحة للدقائق للمدة والفترة.

هل تستخدم الحاسبة منطقتكم الزمنية؟

لا. إنها تجري حساباً حتمياً فقط، من دون تاريخ أو وقت حالي أو توقيت صيفي أو منطقة زمنية.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/biz/timebox-end

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

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

curl -X POST https://api.kit.forhosting.com/biz/timebox-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_time":"09:35","duration_minutes":50}'

const res = await fetch("https://api.kit.forhosting.com/biz/timebox-end", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_time": "09:35",
    "duration_minutes": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/timebox-end",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_time": "09:35",
    "duration_minutes": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/timebox-end", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_time":"09:35","duration_minutes":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_time":"09:35","duration_minutes":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/timebox-end", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "start_time": "09:35",
  "duration_minutes": 50
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.timebox_end",
  "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 الكامل ←