ForHosting KIT · المال والتمويل

حاسبة مدة شريط غانت

شريط غانت من الإثنين 8 يناير إلى الجمعة 19 يناير 2024 يستغرق 12 يوماً تقويمياً أو 10 أيام عمل، مع احتساب اليوم الأول والأخير. ويظهر الرقمان جنباً إلى جنب مع يوم الأسبوع لكل تاريخ. مجاناً في متصفحكم.

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

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

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

مثال محلول

إذا أدخلت

البداية: 2024-01-08
End: 2024-01-19

تحصل على

يوم الأسبوع للبداية: Monday
يوم الأسبوع للنهاية: Friday
الأيام التقويمية (شاملة): 12
أيام العمل (شاملة): 10

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

ماذا تعني مدة شريط غانت

يمتد الشريط في مخطط غانت من يوم البداية حتى يوم النهاية، وفي إدارة المشاريع ينتمي اليومان كلاهما إلى المهمة. لذلك تساوي المدة تاريخ النهاية ناقص تاريخ البداية زائد واحد. في وضع الأيام التقويمية يُحتسب كل يوم في هذه الفترة، وفي وضع أيام العمل تُحتسب أيام الإثنين إلى الجمعة فقط داخل الفترة نفسها. لشريط من 8 إلى 19 يناير 2024 تكون النتيجة 12 يوماً تقويمياً و10 أيام عمل، والفرق هو يوما عطلة نهاية الأسبوع. وتختارون أي القيمتين تُعتمد مدةً للشريط.

متى تستخدمونها وما الأخطاء الشائعة

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

كيف تُحسب مدة شريط غانت (تقويم شامل مقابل أيام العمل)

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

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

تستخدم الخوارزمية أرقام اليوم اليولياني الغريغوري الاستباقي وحساب أسابيع كاملة بتعقيد ثابت، لا كائن Date للمضيف، فتبقى السنوات الكبيسة وأطوال الأشهر وقواعد القرون حتمية عبر بيئات التشغيل.

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

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

أعد حساب أطوال الشريط الشاملة من تواريخ البداية والنهاية المُصدَّرة وعلّم الصفوف التي تختلف فيها مدة غانت لدى المورّد عن وضع التقويم أو أيام العمل.

صياغة المعالم في العقود

اعرض المدى التقويمي ومدى العمل لنفس الشريط عندما يجب أن يميّز النص القانوني بين الأيام المنقضية وأيام العمل.

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

هل تُستثنى عطلات نهاية الأسبوع والعطل الرسمية؟

العطل الرسمية وأيام إغلاق الشركة غير مُنمذَجة؛ طبّق قائمة عطلكم بعد هذا العدّ إن لزم.

ماذا لو كان تاريخ النهاية قبل تاريخ البداية؟

لا يمكن لشريط غانت أن ينتهي قبل أن يبدأ، فتُرفض المدى المعكوس ولا تُفوتر.

هل عدّ الأيام شامل لكلا الطرفين؟

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

كم يوم عمل في شريط مدته 12 يوماً؟

يعتمد ذلك على عدد عطلات نهاية الأسبوع التي يعبرها. من 8 إلى 19 يناير 2024 يشمل الشريط سبتاً وأحداً، فيضم 10 أيام عمل ويومين من عطلة نهاية الأسبوع، ويظهر الرقمان معاً.

ما فائدة إظهار يوم الأسبوع لكل تاريخ؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/biz/gantt-bar-duration

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

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

curl -X POST https://api.kit.forhosting.com/biz/gantt-bar-duration \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-08","end":"2024-01-19"}'

const res = await fetch("https://api.kit.forhosting.com/biz/gantt-bar-duration", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start": "2024-01-08",
    "end": "2024-01-19"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/gantt-bar-duration",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2024-01-08",
    "end": "2024-01-19"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/gantt-bar-duration", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start":"2024-01-08","end":"2024-01-19"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start":"2024-01-08","end":"2024-01-19"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/gantt-bar-duration", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "start": "2024-01-08",
  "end": "2024-01-19"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.gantt_bar_duration",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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

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

كيف تُحسب مدة شريط غانت (تقويم شامل مقابل أيام العمل)

يضبط وضع التقويم duration_days على العدد الشامل لأيام غريغوري بين البداية والنهاية، أي الرقم التسلسلي للنهاية ناقص البداية زائد واحد. تُبلغ الاستجابة دائمًا المقياسين: calendar_days_inclusive وworking_days_inclusive وweekend_days_inclusive مساويًا لفرقهما، إضافة إلى duration_days مساويًا للمقياس المختار عبر working_days_only.

عقد الإدخال وحقول الاستجابة وقواعد التحقق

يجب أن تكون السنوات بين واحد وتسعة آلاف وتسعمائة وتسعة وتسعين. إذا كان end قبل start حصرًا يرفض المعالج الطلب برسالة واضحة بأن شريط غانت لا يمكن أن ينتهي قبل أن يبدأ؛ ولا تُفوتر تلك الإخفاقات. اقرن الأرقام بمحرك الرسوم الخاص بكم إن احتجتم عروضًا بالبكسل؛ هذه النقطة تحسب أعداد الأيام فقط ولا ترسم SVG ولا تُصدر أسماء مهام. أرسل عبر POST كائن JSON بحقول نصية إلزامية start وend بصيغة YYYY-MM-DD الصارمة، مثل 2024-01-08 و2024-01-19. القيمة الاختيارية working_days_only افتراضيها false؛ أرسل true أو false أو صيغًا شائعة مثل yes وno. تُقبل الأسماء البديلة start_date وfrom وbegin وend_date وto وfinish وworkdays_only وbusiness_days_only ليحتاج مستوردو الجداول وتصديرات إدارة المشاريع إلى إعادة تسمية أقل. يُتحقق من كل تاريخ كيوم تقويمي غريغوري حقيقي: قيم مستحيلة مثل 2023-02-29 أو 2024-04-31 تفشل بـ invalid_input مع اسم الحقل. عند النجاح يعيد الجسم start وend موحَّدين وstart_weekday وend_weekday بالإنجليزية وcalendar_days_inclusive وworking_days_inclusive وweekend_days_inclusive والقيمة المنطقية working_days_only وcount_mode كـ calendar أو working وduration_days كالطول المختار وسلسلة formula قصيرة توثّق قاعدة JDN الشاملة. مثال: start 2024-01-08 الإثنين حتى end 2024-01-19 الجمعة يعطي اثني عشر يومًا تقويميًا وعشرة أيام عمل ويومين عطلة وduration_days اثني عشر في وضع التقويم أو عشرة عندما يكون working_days_only true.

أين تثبت واجهة API لمدة شريط غانت فائدتها

لوحات المحافظ التي تستورد تصديرات CSV لخطوط زمنية من Microsoft Project أو Smartsheet أو Jira تحتاج غالبًا إلى تحقق ثانٍ من طول الشريط قبل رسم خرائط حرارية للسعة. تقارن فرق التعاقد المدى التقويمي بمدى العمل عند صياغة معالم يجب أن تستثني السبت والأحد. التواريخ غير الصالحة والمدى المعكوس لا تستهلك الرصيد. يحوّل مخططو الموارد duration_days إلى أيام-أشخاص عندما يكون working_days_only true حتى لا يضخّم حشو نهاية الأسبوع على المخطط عدد العاملين. تستفيد مواقع المحتوى التي تتنافس على حاسبة مدة شريط غانت من أداة مجانية حية يتطابق مسار متصفحها بايتًا ببايت مع مسار API المدفوع مسبقًا على الوحدة النقية نفسها. ولأن التنفيذ من طبقة parse A، تكلف كل مكالمة ناجحة السعر الأساسي المنشور $0.002 بلا رموز نموذج وبلا شبكة صادرة. أبقوا المدخلات سلاسل تقويم ISO وثبّتوا duration_days والتفصيل الشامل في الاختبارات لتحصلوا على أطوال شريط قابلة لإعادة الإنتاج لتدقيق الجداول وعروض صفحات SEO وعمال الحافة دون إقامة قاعدة بيانات كاملة لإدارة المشاريع.

حالات التكامل

تقديرات الموارد بأيام العمل

حوّل شريط مهمة إلى duration_days من الإثنين إلى الجمعة حتى تتجاهل خطط السعة عطلات نهاية الأسبوع المرسومة على المخطط.

أسئلة تقنية

كيف تُحسب مدة شريط غانت؟

قدّم start وend بصيغة YYYY-MM-DD. المدة شاملة: وضع التقويم يستخدم end−start+1 أيامًا كاملة؛ ومع working_days_only true تُحسب فقط أيام الإثنين إلى الجمعة داخل المدى.

كم تكلفة حاسبة مدة شريط غانت؟

أداة المتصفح مجانية. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل مكالمة ناجحة؛ الإدخال غير الصالح لا يُفوتر.

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

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

مثال محلول

ماذا تعني مدة شريط غانت

متى تستخدمونها وما الأخطاء الشائعة

كيف تُحسب مدة شريط غانت (تقويم شامل مقابل أيام العمل)

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

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

صياغة المعالم في العقود

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

كيف تُحسب مدة شريط غانت (تقويم شامل مقابل أيام العمل)

عقد الإدخال وحقول الاستجابة وقواعد التحقق

أين تثبت واجهة API لمدة شريط غانت فائدتها

حالات التكامل

تقديرات الموارد بأيام العمل

أسئلة تقنية

شكرًا