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

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

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

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

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

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

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

ما المقصود بعطلة نهاية أسبوع كاملة

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

كيفية إدخال التاريخين وقراءة النتيجة

أدخلوا التاريخ المرجعي والتاريخ المستهدف بالصيغة الدقيقة YYYY-MM-DD، مستخدمين أربعة أرقام للسنة ورقمين لكل من الشهر واليوم. تتحقق الحاسبة من صحة تواريخ التقويم الميلادي، ولذلك ترفض القيم المستحيلة مثل 30 فبراير بدلاً من نقلها تلقائياً إلى شهر آخر دون تنبيه. يمكن أن يكون التاريخ المستهدف لاحقاً للتاريخ المرجعي أو سابقاً له أو مطابقاً له. وعدد العطلات الكاملة متناظر؛ أي إن تبديل التاريخين نفسيهما لا يغير العدد. يوضح حقل الاتجاه ما إذا كان الهدف في المستقبل أو الماضي أو في اليوم نفسه قياساً إلى المرجع المدخل. كما تعرض الأداة إجمالي الأيام التقويمية شاملاً الطرفين حتى يسهل تدقيق المدة. ولا تفترض الحاسبة تاريخ اليوم تلقائياً. فإذا أردتم العد بدءاً من اليوم، فأدخلوا تاريخ اليوم صراحة في حقل المرجع، وبذلك تظل أي مطالبة محفوظة واضحة وقابلة لإعادة النتيجة نفسها عند تشغيلها لاحقاً.

استخدام العدد في الخطط العملية

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

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

تخطيط مدة رحلة

اعرفوا عدد أزواج السبت والأحد الكاملة الواقعة بين تواريخ الحجز أو المغادرة أو العودة.

تقدير عطلات مشروع

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

مقارنة مدد الفعاليات

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

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

هل يدخل التاريخ المرجعي والتاريخ المستهدف في المدة؟

نعم. يدخل الطرفان في المدة، لكن العطلة لا تحتسب إلا إذا شملت يومي السبت والأحد معاً.

ماذا يحدث إذا كان التاريخ المستهدف أسبق؟

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

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

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

هل يشمل الحساب العطل الرسمية أو الأنماط الإقليمية؟

لا. تعني عطلة نهاية الأسبوع هنا السبت والأحد حصراً، ولا تدخل العطل الرسمية أو أيام الراحة الإقليمية الأخرى.

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

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

ما كلفة طلب API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/weekends-until

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

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

curl -X POST https://api.kit.forhosting.com/date/weekends-until \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference_date":"2026-08-12","target_date":"2026-09-07"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekends-until", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekends-until",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "reference_date": "2026-08-12",
    "target_date": "2026-09-07"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"reference_date":"2026-08-12","target_date":"2026-09-07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekends-until", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "reference_date": "2026-08-12",
  "target_date": "2026-09-07"
}

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

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