ForHosting KIT · التواريخ والوقت

حساب أيام العمل بين تاريخين دون العطلات ونهايات الأسبوع

من 1 إلى 10 يوليو 2026 تبقى 7 أيام عمل بعد استبعاد عطلة نهاية الأسبوع وعطلة يوم 3. احسب أيام الاثنين إلى الجمعة بين تاريخين مع احتساب الطرفين، واخصم أيام الإغلاق الخاصة بك. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

البداية: 2026-07-01
End: 2026-07-10
العطلات: 2026-07-03, 2026-07-04, 2026-07-03

تحصل على

أيام العمل الصافية: 7
الأيام التقويمية: 10
العطلات المستبعدة: 1

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

حددوا الفترة واتجاهها بدقة

أرسلوا start وend كتاريخين حقيقيين بالصيغة الصارمة YYYY-MM-DD. تشمل الفترة الطرفين؛ فإذا كان يوم الاثنين نفسه هو البداية والنهاية عُدّ يوم عمل واحداً. ومن الجمعة إلى الاثنين يُحسب يوما الجمعة والاثنين، ولا يُحسب السبت أو الأحد.

يحدد ترتيب المدخلات الاتجاه: إذا سبق start قيمة end أو ساواها كانت النتيجة موجبة أو صفراً، وإذا جاء start بعدها قيّمت الأداة الفترة الشاملة نفسها ثم عكست إشارة العدّين. لذلك لا يغير تبديل التاريخين إلا الإشارة. وتدعم الأداة السنوات من 0001 إلى 9999 وفق التقويم الميلادي الاستباقي.

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

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

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

قدموا تواريخ العطلات المعتمدة فعلياً في مؤسستكم، بما فيها الأيام البديلة، لأن الأداة لا تستنتج التقويمات القانونية أو المناسبات الإقليمية أو الدينية أو أيام إغلاق الشركات.

استخدموا نتائج حتمية في الأنظمة التشغيلية

ينفذ الحل حساباً بالأعداد الصحيحة على السنة والشهر واليوم في التقويم الميلادي. ولا يستدعي مُنشئ Date في JavaScript، ولا يقرأ ساعة النظام، ولا يستعلم عن منطقة زمنية، ولا يصل إلى الشبكة، ولا يستخدم العشوائية. لذلك يعيد الطلب الكائن نفسه سواء نُفذ في بلد آخر أو متصفح أو عقدة طرفية.

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

ويستخدم التنفيذ المجاني في المتصفح الحل الخالص نفسه، لذا يصلح لفحص الأمثلة قبل أتمتتها.

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

قياس مدة اتفاقية مستوى الخدمة

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

تدقيق انحراف موعد التسليم

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

حساب المهل المالية

احسبوا أيام العمل في فترة فاتورة أو تسوية وحددوا العطلات المصرفية المعتمدة.

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

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

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

لماذا قد تكون النتيجة سالبة؟

إذا جاء start بعد end، توضع إشارة سالبة على العد الشامل. ويحافظ تبديل التاريخين على القيمة المطلقة ويعكس الإشارة.

كيف تُعالج العطلات المكررة أو الواقعة في نهاية الأسبوع؟

تُزال التكرارات ولا تُطرح عطلات نهاية الأسبوع مجدداً.

هل تُحمّل عطلات بلد ما تلقائياً؟

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

هل تؤثر المنطقة الزمنية أو التوقيت الصيفي في النتيجة؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/net-workdays-between

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

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

curl -X POST https://api.kit.forhosting.com/date/net-workdays-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-07-01","end":"2026-07-10"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/net-workdays-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2026-07-01",
    "end": "2026-07-10"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "start": "2026-07-01",
  "end": "2026-07-10"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_holidays 10000

الأخطاء

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

ملاحظات تقنية

حددوا الفترة واتجاهها بدقة

ويظهر هذا التعريف أيضاً في calendar_days ذي الإشارة، مما يسهل تدقيق عمليات التكامل. تتحقق الأداة من التواريخ ولا تصححها ضمنياً؛ فاليوم 30 من فبراير، والشهر 13، وغياب الأصفار، والطوابع الزمنية، والصيغ المحلية تؤدي إلى invalid_input بدلاً من إجابة تبدو صحيحة وهي غير مقصودة.

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

تتضمن الاستجابة excluded_holidays، وهو لا يحسب إلا العطلات الفريدة التي أزالت فعلياً يوم عمل داخل الفترة. عند عكس التاريخين يبقى الاستبعاد متناظراً؛ يظل هذا المؤشر بلا إشارة، بينما يحمل net_workdays اتجاه الفترة.

استخدموا نتائج حتمية في الأنظمة التشغيلية

استخدموا net_workdays للفروق ذات الإشارة، وcalendar_days للتحقق السريع من طول الفترة الشاملة، وexcluded_holidays للتتبع. يبلغ سعر طلب API مقدار $0.002، وتُحسب معالجة الفترة الكاملة عنصراً واحداً.

أسئلة تقنية

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

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

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

شغّل الأداة مجانًا

مثال محلول

حددوا الفترة واتجاهها بدقة

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

استخدموا نتائج حتمية في الأنظمة التشغيلية

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

قياس مدة اتفاقية مستوى الخدمة

تدقيق انحراف موعد التسليم

حساب المهل المالية

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

حددوا الفترة واتجاهها بدقة

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

استخدموا نتائج حتمية في الأنظمة التشغيلية

أسئلة تقنية

شكرًا