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

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

من 1 إلى 11 يناير 2024 توجد 10 أيام. أدخل تاريخين لتحصل على عدد الأيام التقويمية الكاملة بينهما، مع رقم بإشارة يوضح ما إذا كان التاريخ الثاني يأتي قبل الأول. مجاني في متصفحك.

  • مجاني
  • يعمل في متصفحك
  • دون تسجيل
  • بياناتك لا تغادر جهازك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا
إذا أدخلت
البداية
2024-01-01
النهاية
2024-01-11
تحصل على
الأيام
10
الأيام المُوقَّعة
10
سنة البداية
2,024
شهر البداية
1

تأخذ حاسبة الأيام بين تاريخين هذه تاريخَين ميلاديَّين بصيغة صارمة YYYY-MM-DD وتُرجع العدد الصحيح للأيام التقويمية التي تفصل بينهما. من الفحوص الكلاسيكية: 2024-01-01 إلى 2024-01-11 يُعطي عشرة أيام، و2024-02-28 إلى 2024-03-01 يُعطي يومَين في سنة كبيسة، والنقطتان المتطابقتان تُعطيان صفرًا. يستخدم المحرك حسابًا ميلاديًّا حتميًّا استرجاعيًّا فقط: يتحقّق من أن كل يوم موجود فعلًا على التقويم، ويحوّل الثلاثيّتَين إلى عدد أيام تسلسلي، ويطرحهما، ويذكر كلًّا من المسافة المطلقة والفارق المُوقَّع من نهاية ناقص بداية دون نداءات شبكة أو أخذ عيّنات عشوائية أو الاعتماد على ساعة الجهاز.

ماذا تعني مسافة الأيام الكاملة وماذا تحتوي الاستجابة

عدّ الأيام التقويمية الكاملة بين تاريخين يجيب عن سؤال مختلف عن عدّ أيام العمل، أو العمر بالسنوات والأشهر، أو طرح الطوابع الزمنية الحسّاسة للمنطقة الزمنية: فهو يقيس مسافة مدنية بحتة على التقويم الميلادي، من منتصف الليل إلى منتصف الليل، دون تخطّي عطلات نهاية الأسبوع أو العطلات الرسمية أو تحوّلات التوقيت الصيفي. من الحالات المرفوضة: غياب حقل start أو end، أو صيغ خاطئة مثل 2024/01/01، أو أشهر مستحيلة، أو أيام غير موجودة مثل 2023-02-29، وسنوات خارج نطاق واحد إلى 9999.

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

أين يفيد حساب مسافة الأيام في التخطيط والفوترة والبرمجيات

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

يستدعي المطوّرون العقد من النصوص البرمجية لتوليد متجهات اختبار حتمية للمُجدوِلات، أو لتأكيد حقول المدّة في الفواتير والاشتراكات، أو لتلبية متطلّبات منتج تتطلّب مسافة تقويمية بحتة دون انحراف منطقة زمنية من كائن Date في الجهاز. يستخدم المعلّمون وكاتبو المعايير الأداة لعرض مسافات الأيام الكبيسة مثل 2024-02-28 إلى 2024-03-01 مقابل الزوج نفسه في سنة عادية دون الاعتماد على تطبيقات حاسبة مبهمة تدرج بصمت أوقات اليوم.

اقرنها بمساعدات طرح الأيام أو تحويل الحقبة الزمنية أو أسبوع ISO حين تحتاج خطوات تقويمية ذات صلة، وبأدوات حتمية مجانية أخرى عند بناء مختبر صغير من أدوات التاريخ.

نوافذ الدفع والإشعار

قِس الأيام التقويمية الكاملة بين تاريخ فاتورة وتاريخ استحقاق، أو بين حدث ويوم إشعار مطلوب، دون انحراف منطقة زمنية.

مسافات السنة الكبيسة ونهاية الشهر

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

بيانات اختبار حتمية

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

ماذا يحدث مع السنوات الكبيسة والتواريخ غير الصالحة؟

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

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

لا. تعدّ هذه الأداة أيامًا تقويمية ميلادية بحتة فقط. لا تتخطّى أيام العمل غير الرسمية ولا تحلّل الأوقات أو المناطق الزمنية.

هل يهم ترتيب التاريخين؟

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

هل يُحتسب اليوم الأول؟

يقيس العدد المسافة من منتصف الليل إلى منتصف الليل، لذا يعطي الفارق من 1 إلى 11 يناير 10 أيام لا 11. والتاريخان المتطابقان يعطيان 0.

فيمَ يفيد عدّ الأيام بين تاريخين؟

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

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

POSThttps://api.kit.forhosting.com/date/days-between

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

curl -X POST https://api.kit.forhosting.com/date/days-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01","end":"2024-01-11"}'
{
  "start": "2024-01-01",
  "end": "2024-01-11"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.days_between",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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

ماذا تعني مسافة الأيام الكاملة وماذا تحتوي الاستجابة

تزوّد الأداة بتاريخ بداية وتاريخ نهاية كسلسلتَين صارمتَين بصيغة YYYY-MM-DD؛ لا يلزم أن يكون الترتيب زمنيًّا لأن حقل days المطلق غير سالب دائمًا بينما يحافظ signed_days على الاتجاه حين تكون النهاية أبكر من البداية. تتحقّق الحاسبة من أن كلا اليومَين يوم تقويمي حقيقي — 29 فبراير فقط في السنوات الكبيسة، وثلاثون يومًا في أبريل، ولا يوم اثنين وثلاثين مطلقًا — ثم تُرجع سلسلتَي البداية والنهاية المُطبَّعتَين، وdays كالمسافة المطلقة الكاملة بالأيام، وsigned_days كالتسلسل النهاية ناقص التسلسل البداية، والحقول المكوّنة start_year وstart_month وstart_day وend_year وend_month وend_day لتسهيل التمرير إلى أدوات أخرى، وتذكيرًا مختصرًا بالصيغة. لا توجد بداية أسبوع تعتمد على المنطقة، ولا تقريب عائم لطول اليوم، ولا اعتماد على كائن Date في الجهاز: فإما أن يكون كلا المُدخلَين يومَين تقويميَّين حقيقيَّين ضمن نافذة السنة المدعومة وتكون المسافة محدَّدة تمامًا، أو يفشل الطلب برمز invalid_input.

كيف تُقرأ البداية والنهاية وكيف يبقى العدّ قابلًا لإعادة الإنتاج

يجب أن تطابق كل سلسلة أربعة أرقام، ثم شرطة، ثم رقمَين، ثم شرطة أخرى، ثم رقمَين؛ تُزال المسافات البادئة أو اللاحقة، لكن التواريخ الجزئية أو يوم السنة الترتيبي وحده أو أسماء الأشهر أو الأوقات المضمّنة لا تُوسَّع هنا. بعد التحليل، يجب أن تقع كل سنة بين 1 و9999، وكل شهر بين 1 و12، وكل يوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، مع اتّباع السنوات الكبيسة قاعدة الميلادي: القابلية للقسمة على أربعة إلا سنوات القرن غير القابلة للقسمة على أربعمئة. الحقل الأول المفضّل هو start، لكن الأسماء البديلة from وdate1 وa وbegin مقبولة كي تستطيع جداول البيانات وسلاسل الاستعلام والنماذج المُكتَّبة إعادة استخدام العقد نفسه دون إعادة تسمية الأعمدة. الحقل الثاني المفضّل هو end، بأسماء بديلة to وdate2 وb وfinish للسبب نفسه. داخليًّا يحوّل المحرك كل ثلاثيّة مدنية إلى عدد أيام تسلسلي ميلادي استرجاعي باستخدام تخطيط days_from_civil المعروف، ويطرح تسلسل البداية من تسلسل النهاية للحصول على signed_days، ثم يأخذ القيمة المطلقة لِـ days — حساب أعداد صحيحة بحت مستقر بتًّا للبت عبر بيئات التشغيل. التواريخ المتطابقة تُعطي صفرًا؛ وعكس الزوج يقلب إشارة signed_days فقط ويترك days دون تغيير. اقرن التشغيل المجاني في المتصفح بالواجهة البرمجية المدفوعة حين تحتاج مسافة الأيام نفسها داخل خط أنابيب آلي.

أين يفيد حساب مسافة الأيام في التخطيط والفوترة والبرمجيات

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

كم تكلّف حاسبة الأيام بين تاريخين؟

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

كيف يُعرَّف عدّ الأيام؟

يحوّل المحرك كلا التاريخَين المُتحقَّق منهما بصيغة YYYY-MM-DD إلى عدد أيام تسلسلي ميلادي استرجاعي ويطرحهما. days هي المسافة المطلقة الكاملة بالأيام؛ وsigned_days هي النهاية ناقص البداية.

هل يهمّ الترتيب إذا كانت النهاية قبل البداية؟

days غير سالبة دائمًا. signed_days تكون سالبة حين تكون النهاية أبكر من البداية، فتستطيع الاحتفاظ بالاتجاه الزمني حين تحتاجه.

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