احسب أيام العمل الفعلية بين تاريخين
أداة تحسب عدد أيام العمل الفعلية بين تاريخين، مستثنية عطلة نهاية الأسبوع التي تحددها — الجمعة والسبت في معظم دول الخليج، أو السبت والأحد في أنظمة أخرى — لمعرفة الموعد الحقيقي لتسليم مشروع أو انتهاء مهلة تعاقدية.
شغّل الأداة مجانًا
تعمل هذه الأداة داخل متصفحك — مجانًا، ولا تُرسل بياناتك إلى أي خادم
لماذا عدّ الأيام بالتقويم وحده يُضلِّل
الفرق بين تاريخين بالتقويم العادي يشمل أيام العطلة، فمهلة 10 أيام تقويمية تتضمن يومين أو ثلاثة عطلة فعليًا لا عمل فيها، فيظن من يعتمد على العدّ البسيط أن أمامه وقتًا أطول مما هو متاح فعليًا لإنجاز المهمة. تستثني الأداة أيام نهاية الأسبوع تلقائيًا من الحساب، فتُظهر عدد أيام العمل الحقيقية المتبقية.
عطلة الجمعة والسبت في الخليج
تعتمد معظم دول الخليج عطلة نهاية الأسبوع يومي الجمعة والسبت، بخلاف أنظمة أخرى تعتمد السبت والأحد؛ هذا الفرق يربك من يتعامل مع فرق دوليين لا يعرفون تفصيل جدول العطل المحلي. تتيح الأداة اختيار أيام العطلة الأسبوعية بدقة حسب الدولة أو النظام المطلوب، فيتطابق الحساب مع الجدول الفعلي لكل طرف.
إضافة أيام عطل رسمية عند الحاجة
إلى جانب عطلة نهاية الأسبوع الثابتة، تقع أحيانًا عطل رسمية إضافية كعيد وطني أو عطلة دينية تقع في يوم عمل عادي وتؤثر في المهلة الفعلية. تسمح الأداة بإضافة تواريخ عطل استثنائية لاستثنائها من الحساب أيضًا، فتحصل على عدد أيام العمل الدقيق لا التقريبي.
احتساب مهل عقود متعددة عبر الـAPI
لنظام إدارة مشاريع يتابع عشرات المواعيد النهائية في وقت واحد، يتيح الـAPI حساب أيام العمل المتبقية لكل مهمة برمجيًا بسعر $0.002 لكل طلب، فيعرض النظام تحذيرًا تلقائيًا حين تقترب مهلة عمل حقيقية من نهايتها لا مهلة تقويمية مضلِّلة.
حالات الاستخدام
موعد تسليم عقد مقاولة
يحسب فريق مؤسسة النخيل للمقاولات موعد التسليم الفعلي لعقد مدته 30 يومًا من تاريخ التوقيع، مستثنيًا أيام الجمعة والسبت والعطلة الوطنية الواقعة ضمن الفترة.
مهلة رد على عرض سعر
تراجع فاطمة الزهراني مهلة الرد على عرض سعر مدته أسبوعان، وتكتشف بعد استثناء عطلة نهاية الأسبوع أن أيام العمل الفعلية المتاحة أقل مما بدا للوهلة الأولى.
تتبع مواعيد نهائية متعددة في نظام مشاريع
يتابع نظام إدارة مشاريع في شركة الخليج الرقمية عشرات المهام النشطة، ويحسب أيام العمل المتبقية لكل منها عبر الـAPI ليعرض تنبيهًا عند اقتراب أي مهلة فعلية.
الأسئلة الشائعة
ما أيام العطلة الأسبوعية المعتمدة افتراضيًا؟
الجمعة والسبت، وفق النظام المتبع في معظم دول الخليج؛ يمكن تغييرهما لأي أيام أخرى حسب الحاجة.
هل تستثني الأداة العطل الرسمية أيضًا؟
نعم، يمكن إضافة تواريخ عطل رسمية محددة لاستثنائها من حساب أيام العمل، بجانب عطلة نهاية الأسبوع الثابتة.
هل الحساب يشمل تاريخ البداية والنهاية معًا؟
يعتمد على اختيارك؛ الأداة تتيح تحديد هل يُحسَب اليوم الأول والأخير ضمن العدّ أم يُستثنى.
كم تكلفة الحساب الآلي لعدة مهل عبر الـAPI؟
$0.002 لكل طلب حساب؛ الاستخدام اليدوي لتاريخين من المتصفح يبقى مجانيًا بلا حدّ.
هل تراعي الأداة عطل دول خارج الخليج؟
يمكن ضبط أيام نهاية الأسبوع وإضافة أي عطل رسمية يدويًا مهما كانت الدولة؛ الأداة لا تفترض جدولًا واحدًا ثابتًا.
هل تعمل الأداة من الجوال؟
نعم، صفحة ويب عادية تعمل من متصفح الجوال بنفس الطريقة على الحاسوب.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/dev/business-days \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/dev/business-days", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/business-days",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/business-days", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/business-days", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"items": [
"valor-1",
"valor-2"
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.business_days",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |