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

حساب أيام العمل المتبقية في الشهر دون العطلات

تحسب أداة أيام العمل المتبقية في الشهر أيام الاثنين إلى الجمعة ابتداءً من تاريخ ISO صريح وحتى آخر يوم تقويمي من الشهر نفسه.

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

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

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

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

اختاروا التاريخ الذي يبدأ منه العد

أدخلوا تاريخًا تقويميًا صريحًا بالصيغة الصارمة YYYY-MM-DD، مثل 2026-07-20. يحدد هذا التاريخ أول يوم يمكن احتسابه يوم عمل، كما يحدد الشهر الذي ينتهي النطاق بآخر يوم فيه. الحساب شامل لتاريخ البداية؛ فإذا وافق يوم الاثنين أمكن احتسابه فورًا، أما إذا وافق يوم السبت فلا يُحتسب. لا توجد أي إحالة خفية إلى تاريخ اليوم أو المنطقة الزمنية للخادم أو الإعدادات المحلية للمتصفح. لذلك تلائم النتيجة التقارير القابلة للتكرار ومسارات العمل المجدولة والاختبارات والسجلات التي قد تحتاج إلى إعادة الحساب لاحقًا. تتضمن الاستجابة تاريخ البداية الموحّد وتاريخ نهاية الشهر وعدد الأيام التقويمية التي جرى فحصها، وتوضح كذلك أن النطاق شامل. إذا أردتم بدء العد غدًا، فأرسلوا تاريخ ISO الصريح للغد بدل إجراء طرح أو الاعتماد على اصطلاح غير معلن. تُرفض التواريخ غير الصالحة، بما فيها أيام الكبيسة المستحيلة أو قيم الشهر واليوم غير المكتوبة برقمين، بدل تصحيحها بصمت إلى تاريخ آخر. وتُعالج السنوات من 0001 إلى 9999 وفق قواعد السنوات الكبيسة في التقويم الميلادي.

استبعدوا نهايات الأسبوع والعطلات بلا احتساب مزدوج

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

اقرؤوا النتيجة وتحققوا منها وأتمتوا استخدامها

استخدموا workdays_remaining بوصفه الجواب الأساسي. تتيح الحقول المساندة التحقق من الحساب: تساوي calendar_days مجموع weekend_days وholiday_days وworkdays_remaining. يعرض الحقل month_end الحد الدقيق، وهو مفيد خصوصًا في فبراير والسنوات الكبيسة، بينما يعرض holiday_days عطلات أيام الأسبوع التي غيّرت الإجمالي فعليًا فقط. تلائم هذه البنية مواعيد إقفال الرواتب وتخطيط التسليم ولوحات القدرة الشهرية وتوقعات مستوى الخدمة وحساب المواعيد النهائية الشخصية. في التكامل المؤتمت، احتفظوا بتاريخ الإدخال وقائمة العطلات إلى جانب الاستجابة كي يتمكن المراجعون مستقبلًا من إعادة إنتاج الرقم نفسه. تبلغ كلفة نقطة النهاية $0.002 لكل طلب عبر API، ويمثل كل طلب عملية حساب واحدة بصرف النظر عن عدد العطلات المقدمة. تتم المعالجة بعمليات تقويم محلية؛ فلا تُرسل طلبات عبر الشبكة ولا يُستشار أي مزود مباشر للعطلات. إذا كان تقويم جهة العمل يتضمن فترات إغلاق، فأضيفوا كل يوم عمل متأثر بصفته عطلة صريحة. أما إذا احتجتم إلى حساب أيام العمل بين تاريخين اعتباطيين أو إضافة مدة إلى تاريخ، فاستخدموا قدرة لحساب النطاق أو لإضافة أيام العمل.

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

القدرة الشهرية للموظفين

قدّروا قدرة أيام العمل المتبقية في شهر التخطيط انطلاقًا من تاريخ تقرير ثابت وقائمة إغلاقات جهة العمل.

مواعيد إقفال الفواتير والرواتب

احسبوا أيام المعالجة المتاحة قبل نهاية الشهر مع استبعاد نهايات الأسبوع وعطلات المكتب المعروفة.

تقارير مواعيد قابلة لإعادة الإنتاج

احفظوا تاريخًا صريحًا وقائمة عطلات لإعادة حساب العد التنازلي حتى نهاية الشهر لاحقًا بالنتيجة المطابقة.

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

هل يُحتسب تاريخ البداية؟

نعم، يُحتسب إذا وافق يومًا من الاثنين إلى الجمعة ولم يكن مدرجًا ضمن العطلات.

هل تستخدم الحاسبة تاريخ اليوم؟

لا، يجب أن تقدموا التاريخ صراحة، ولا تُقرأ ساعة النظام مطلقًا.

ماذا يحدث إذا وافقت العطلة نهاية الأسبوع؟

تُحتسب يومًا من نهاية الأسبوع فقط، ولذلك لا تخفض إجمالي أيام العمل مرتين.

هل يمكنني إدخال عطلات من أشهر أخرى؟

نعم، تُتجاهل تواريخ العطلات الصالحة الواقعة خارج النطاق الشامل ولا تغير النتيجة.

ما أسبوع العمل الذي تستخدمه الأداة؟

تعد الأداة الأيام من الاثنين إلى الجمعة أيام عمل، والسبت والأحد نهاية الأسبوع.

ما كلفة عملية حساب عبر API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/workdays-remaining-month

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

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

curl -X POST https://api.kit.forhosting.com/date/workdays-remaining-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-20"}'

const res = await fetch("https://api.kit.forhosting.com/date/workdays-remaining-month", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-07-20"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/workdays-remaining-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-07-20"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/workdays-remaining-month", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-07-20"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-07-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/workdays-remaining-month", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2026-07-20"
}

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

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