ForHosting KIT · المنزل والطبخ والهوايات

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

من 1 إلى 11 يناير 2024 توجد 10 ليالٍ بين التاريخين، أو 11 يومًا إذا احتُسب اليوم الأول والأخير معًا. اختر طريقة العدّ التي تناسب حجزك أو إجازتك أو إعلانك. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

البداية: 2024-01-01
End: 2024-01-11

تحصل على

الطرفان: Exclude
الأيام: 10
الأيام بإشارة: 10
سنة البداية: 2,024

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

ما الذي يغيّره include مقابل exclude في عدد الأيام

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

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

أين يظهر عدّ أيام بمفتاح طرفين في العمل الحقيقي

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

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

لا يُخزَّن شيء بعد إعادة الرد. اقرنوا هذه الصفحة بعدّ تنازلي للأيام حتى تاريخ حين يكون السؤال الأيام المتبقية حتى أفق مستقبلي، أو بأداة عدّ عطل حين تهمّ السبوت والآحاد فقط. أبقوا هذه الصفحة لبحث «عدد الأيام» بجواب صريح include أو exclude.

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

ليالي الفندق مقابل أيام التقويم لإقامة

حوّلوا الوصول والمغادرة إلى ليالٍ (exclude) أو أيام تقويم للرحلة (include) دون انحراف منطقة من ساعة المضيف.

نوافذ الإجازة والتغطية والقبول

عدّوا كل يوم مدني من التاريخ الأول حتى الأخير حين يغطي نموذج الطرفين، أو الفجوة المفتوحة حين تقول السياسة «أيام بعد».

فحوص مدرسية وتكامل لانزياح الواحد

أظهروا لماذا «بما في ذلك التاريخان» يزيد واحدًا على طرح تسلسلي، وثبّتوا العددين في اختبارات يجب ألا تعتمد على Date.

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

كيف يُحسب عدد الأيام عند استبعاد الطرفين أو إدراجهما؟

يصير التاريخان رقمي يوم تسلسليين غريغوريين. exclude هو الفرق المطلق. include هو ذلك الفرق زائد واحد حتى يُحسب الطرفان. أرسلوا YYYY-MM-DD في start وend.

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

يعيد exclude القيمة 0 — لا فجوة مفتوحة. ويعيد include القيمة 1 — ذلك اليوم المدني الواحد هو الفاصل المغلق كله.

لماذا يجب اختيار include أو exclude؟

ليالي الفندق وأيام الإجازة و«كم يومًا تستغرق الرحلة» تختلف في عدّ التاريخين.

ماذا إن لم يكن أحد التاريخين يوم تقويم حقيقيًا؟

يُقبل 29 فبراير في سنة كبيسة فقط. تُفحص أطوال الشهور في الحقلين.

كم ليلة في إقامة فندقية من الاثنين إلى الخميس؟

ثلاث ليالٍ إذا عددت ما بين التاريخين، وأربعة أيام إذا أدرجت يوم الوصول ويوم المغادرة معًا. الرقم الأول يطابق فاتورة الفندق، والثاني يعبّر عن أيام غيابك.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/life/number-days

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

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

curl -X POST https://api.kit.forhosting.com/life/number-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01","end":"2024-01-11"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/number-days",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2024-01-01",
    "end": "2024-01-11"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"start":"2024-01-01","end":"2024-01-11"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/number-days", 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-01",
  "end": "2024-01-11"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`year_min`	1
`year_max`	9999

الأخطاء

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

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

إن لم يكن أحد المدخلين يومًا غريغوريًا حقيقيًا، يفشل الطلب بـ invalid_input ولا يُحسب. يستخدم المحرك حسابًا غريغوريًا صحيحًا فقط: السنوات الكبيسة وأطوال الشهور وأرقام الأيام التسلسلية تُحسم دون ساعة المضيف ودون عشوائية ودون نداء شبكة، فتتفق ودجة المتصفح المجانية وواجهة API بايتًا ببايت. تكلف نداءات API الناجحة $0.002.

ما الذي يغيّره include مقابل exclude في عدد الأيام

تجعل هذه الصفحة الاختيار صريحًا بحقل endpoints: يعيد exclude الفاصل المفتوح، وهو الفرق المطلق لرقمي يوم تسلسليين غريغوريين؛ ويعيد include ذلك الفرق زائد واحد حتى يجلس الطرفان داخل العدّ. لذلك تعطي أزواج اليوم نفسه صفرًا تحت exclude وواحدًا تحت include. عكس الزوج لا يغيّر أبدًا رقم الأيام المطلق؛ وحده signed_days يقلب الإشارة كي يحفظ أنبوب الاتجاه الزمني. ولأن التنفيذ لا يبني أبدًا كائن Date في جافاسكربت، ينتج الزوج نفسه والوضع نفسه دائمًا العدد الصحيح ذاته، في عامل Worker أو في متصفح بطوكيو أو في منصة اختبار بـ TZ مضبوط على America/New_York.

كيف يُقرأ تاريخا ISO ووضع الطرفين

الحقلان المطلوبان هما start وend، وكل منهما يوم تقويم حقيقي بصيغة YYYY-MM-DD. عند حذفه يعتمد المحرك exclude، موافقًا القراءة المعتادة لليالي بين التاريخين أو لمنتصفات الليل بينهما. يجب أن يكون كل تاريخ يومًا غريغوريًا حقيقيًا: سنة من أربع خانات وشهر من خانتين ويوم من خانتين، ويُسمح بتسعة وعشرين فبراير في سنة كبيسة فقط. تُحدَّ السنوات بالنطاق الشامل من واحد إلى تسعة آلاف وتسعمائة وتسعة وتسعين حتى تبقى سلاسل ISO الرباعية معرّفة جيدًا. تشمل الفحوص الكلاسيكية ألفين وأربعة وعشرين شرطة صفر واحد شرطة صفر واحد إلى ألفين وأربعة وعشرين شرطة صفر واحد شرطة واحد واحد تحت exclude فتعطي عشرة أيام، وألفين وأربعة وعشرين شرطة صفر اثنين شرطة ثمانية وعشرين إلى ألفين وأربعة وعشرين شرطة صفر ثلاثة شرطة صفر واحد تحت include فتعطي ثلاثة أيام عبر يوم كبيس. تُقبل الأسماء البديلة from وdate1 وbegin وa للتاريخ الأول؛ وto وdate2 وfinish وb للثاني، حتى يعيد نموذج أو سلسلة استعلام أو عمود جدول استخدام العقد. حقل endpoints الاختياري تعداد مغلق: exclude أو include. تُقبل الأسماء البديلة mode وcount وinclude_endpoints للمفتاح نفسه. الحقول الغائبة والسلاسل الفارغة والأنواع غير النصية والأنماط المعطوبة والشهور المستحيلة وتسعة وعشرون فبراير خارج الكبيس تفشل بـ invalid_input يسمي الحقل. قيمة endpoints ليست exclude ولا include تفشل بالطريقة نفسها. عند النجاح يعيد الجسم سلسلتي start وend القانونيتين، ووضع endpoints المحلول، وdays عدًّا غير سالب، وsigned_days بالاتجاه الزمني، ومكوّنات السنة-الشهر-اليوم للتاريخين، وسلسلة صيغة قصيرة. تكلف طلبات API الناجحة $0.002؛ ولا تُفوتر المدخلات غير الصالحة.

أين يظهر عدّ أيام بمفتاح طرفين في العمل الحقيقي

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

أسئلة تقنية

كم تكلفة حاسبة عدد الأيام؟

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

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

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

مثال محلول

ما الذي يغيّره include مقابل exclude في عدد الأيام

أين يظهر عدّ أيام بمفتاح طرفين في العمل الحقيقي

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

ليالي الفندق مقابل أيام التقويم لإقامة

نوافذ الإجازة والتغطية والقبول

فحوص مدرسية وتكامل لانزياح الواحد

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

ما الذي يغيّره include مقابل exclude في عدد الأيام

كيف يُقرأ تاريخا ISO ووضع الطرفين

أين يظهر عدّ أيام بمفتاح طرفين في العمل الحقيقي

أسئلة تقنية

شكرًا