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

طرح مدتين بصيغة HMS

يمكنكم طرح مدة بالساعات والدقائق والثواني من مدة أخرى من دون تحويل القيم يدويا. أدخلوا مدتين غير سالبتين بصيغة HH:MM:SS، فتحسب الأداة المدة الثانية مطروحة من الأولى، وتجري الاستلاف بين الثواني والدقائق عند الحاجة، ثم تعيد نتيجة دقيقة ذات إشارة.

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

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

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

لا تقتصر الساعات على نظام 24 ساعة، لذلك تصلح الأداة للمشروعات ومدد الوسائط والتدريب ودورات الآلات وغيرها من الفترات الطويلة. تعتمد العملية حصرا على القيمتين اللتين تقدمونهما.

أدخلوا مددا منقضية لا أوقاتا يومية

ضعوا في الحقل الأول المدة التي تريدون الطرح منها، وفي الحقل الثاني المدة المراد طرحها. تستخدم كل قيمة صيغة HH:MM:SS، مع رقمين للدقائق ورقمين للثواني. يجوز أن تتكون الساعات من رقم واحد إلى ستة أرقام، ولذلك تعد 125:30:00 قيمة صحيحة رغم أن 125 ليست ساعة على قرص الساعة. يجب أن تقع الدقائق والثواني بين 00 و59 لأن الحاسبة تتوقع مدخلات مطبعة. استخدموا 00 للوحدة الفارغة، مثل 7:00:09 للتعبير عن سبع ساعات وتسع ثوان. تكون المدخلات غير سالبة؛ أما الإشارة فتنتمي إلى الفرق المحسوب ولا توضع على أي من المدتين الأصليتين. يمنع هذا الفصل العبارات الملتبسة التي تحتوي فترتين سالبتين. يحافظ الحساب بدقة على الترتيب الرياضي: المدة الأولى ناقص المدة الثانية. إذا تساوت القيمتان، تكون النتيجة 00:00:00 وتكون الإشارة صفرا. تتجاهل الأداة المسافات المحيطة، لكنها ترفض الكلمات وكسور الثواني وأجزاء التواريخ ولاحقتي AM وPM، كي يكون لكل قيمة مقبولة معنى واحد محدد.

افهموا الاستلاف والنتيجة السالبة

يتبع طرح HMS طريقة الاستلاف نفسها المستخدمة في الحساب الورقي. إذا كانت الثواني المتاحة أقل من الثواني المطلوب طرحها، تتحول دقيقة واحدة إلى ستين ثانية إضافية. وبعد إنهاء خانة الثواني، إذا كانت الدقائق المتاحة أقل من الدقائق المطلوب طرحها، تتحول ساعة واحدة إلى ستين دقيقة إضافية. تبين الاستجابة ما إذا وقع كل نوع من الاستلاف، مما يفيد في التعليم والتدقيق وعرض خطوات الحساب. عندما تكون المدة الثانية أطول من الأولى، تقارن الحاسبة الطولين الكاملين، ثم تطرح المقدار الأصغر من الأكبر بالقواعد نفسها، وتضع علامة السالب قبل الفرق المطبّع. لا تنتج الأداة مكونات مربكة مثل دقائق سالبة أو 75 ثانية. فعلى سبيل المثال، يمثل الفرق السالب بالصيغة -02:04:09 من دون مزج ساعة سالبة بوحدات دنيا. تكون قيمة حقل الإشارة الرقمي -1 أو 0 أو 1، بينما يحتفظ total_seconds بالفرق ذي الإشارة للبرامج التي تحتاج إلى متابعة العمليات الحسابية بدلا من عرض النص المنسق فقط.

استخدموا الناتج المطبّع بصورة موثوقة

تتضمن النتيجة نص HMS المطبّع، وإجمالي الثواني ذا الإشارة، والإشارة نفسها، ومكونات مطلقة منفصلة للساعات والدقائق والثواني. تدعم هذه التوليفة العرض البشري والحسابات اللاحقة من دون إلزام البرنامج بتحليل شرح لغوي. ولأن القيم تمثل مددا، فلا تعود الساعات إلى الصفر عند 24؛ إذ تعني 49:10:00 تسعا وأربعين ساعة منقضية وعشر دقائق. يستخدم الحساب عمليات صحيحة محدودة فقط. ولا يراجع التاريخ الحالي أو المنطقة الزمنية أو قواعد التوقيت الصيفي أو الإعدادات المحلية أو خدمة شبكية أو نموذجا لغويا، ولذلك تنتج المدخلات المتطابقة مخرجات متطابقة دائما. تناسب الأداة نصوص البناء البرمجية ومراجعة سجلات العمل وحالات الاختبار ومسارات الوسائط والتقارير القابلة للتكرار. تحققوا من الإشارة قبل تفسير اتجاه الفرق، لأن قيم المكونات نفسها مقادير غير سالبة دائما. الاستخدام عبر المتصفح مجاني، وتبلغ كلفة كل طلب API آلي $0.002.

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

مقارنة مدد الوسائط

اطرحوا مدة النسخة المحررة من الأصلية واعرفوا بدقة مقدار الوقت المحذوف أو المضاف مع إشارته.

مطابقة وقت العمل المسجل

احسبوا الفرق بين مدتي عمل متراكمتين حتى إذا تجاوز أحد الإجماليين 24 ساعة.

فحص توقيت الفعاليات

قارنوا المدة المخططة بالمدة المقاسة مع الاحتفاظ بالثواني وتفاصيل الاستلاف الصريحة.

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

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

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن استخدام حاسبة المتصفح مجانا.

هل يمكن أن تكون النتيجة سالبة؟

نعم. إذا كانت المدة الثانية أطول، تبدأ النتيجة المطبعة بعلامة سالب وتكون قيمة حقل الإشارة -1.

هل يجوز أن تتجاوز الساعات 23؟

نعم. القيم مدد منقضية وليست أوقاتا على الساعة، ولذلك يمكن أن تتراوح الساعات من 0 إلى 999999.

لماذا يجب أن تقل الدقائق والثواني عن 60؟

يجب أن تستخدم المدخلات صيغة HMS مطبعة سلفا. يجري الاستلاف أثناء الطرح وتظل المخرجات مطبعة.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/hms-subtract

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

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

curl -X POST https://api.kit.forhosting.com/date/hms-subtract \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_duration":"12:05:10","second_duration":"03:47:55"}'

const res = await fetch("https://api.kit.forhosting.com/date/hms-subtract", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "first_duration": "12:05:10",
    "second_duration": "03:47:55"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/hms-subtract",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "first_duration": "12:05:10",
    "second_duration": "03:47:55"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/hms-subtract", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"first_duration":"12:05:10","second_duration":"03:47:55"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"first_duration":"12:05:10","second_duration":"03:47:55"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hms-subtract", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "first_duration": "12:05:10",
  "second_duration": "03:47:55"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_hours 999999

الأخطاء

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

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