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

عداد الأشهر

من يناير 2020 إلى يونيو 2024 هناك 53 شهرًا كاملًا. أدخل السنة والشهر فقط لكل تاريخ، دون حاجة إلى اليوم، واحصل على عدد الأشهر لعقد إيجار أو مدة خدمة أو اشتراك أو مشروع. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

سنة البداية: 2,020
شهر البداية: 1
سنة النهاية: 2,024
شهر النهاية: 6

تحصل على

الأشهر: 53
عدد الأشهر: 53

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

معنى عدد الأشهر الكاملة بين تاريخين من نوع سنة-شهر

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

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

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

تلك ميزة لقصد البحث لا حقل يوم مفقود: عداد الأشهر هو الأداة التي تفتحونها حين يكون اليوم غير ذي صلة أو مجهولًا.

أين يثبت عداد الأشهر جدواه

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

ويحوّل مديرو المشاريع شهر الانطلاق وشهر التسليم إلى مدة توضع في مخطط Gantt أو عرض بسعر ثابت. لا يستهلك التحقق الفاشل الرصيد.

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

آجال الإيجار والاستئجار

عدّوا أشهرًا كاملة من سنة-شهر دخول إلى سنة-شهر خروج حين يُكتب العقد بأشهر تقويمية لا بأيام دقيقة.

مدة الخدمة بالأشهر

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

نوافذ الاشتراك والمشروع

حوّلوا شهر بدء الخطة وشهر انتهائها إلى عدد دورات فوترة، أو شهر الانطلاق وشهر التسليم إلى مدة مشروع.

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

ماذا يحدث إن كان الشهر أو السنة غير صالح؟

يجب أن تكون الأشهر أعدادًا صحيحة من 1 إلى 12 والسنوات أعدادًا صحيحة من 1 إلى 9999. ولا تُفوتر تلك الإخفاقات.

هل يحتاج عداد الأشهر إلى يوم الشهر؟

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

ماذا إن سبق تاريخ النهاية تاريخ البداية؟

الزوج نفسه بترتيب معكوس يقلب إشارة months فقط.

هل يُحتسب شهر البداية ضمن الأشهر؟

لا، يقيس العداد الفرق بين الشهرين. فمن يناير 2020 إلى فبراير 2020 شهر واحد، ومن يناير 2020 إلى يناير 2021 اثنا عشر شهرًا، والسنة والشهر نفسهما يعطيان صفرًا.

متى أستخدم عداد الأشهر؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/life/month-counter

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

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

curl -X POST https://api.kit.forhosting.com/life/month-counter \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}'

const res = await fetch("https://api.kit.forhosting.com/life/month-counter", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_year": 2020,
    "start_month": 1,
    "end_year": 2024,
    "end_month": 6
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/month-counter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_year": 2020,
    "start_month": 1,
    "end_year": 2024,
    "end_month": 6
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/month-counter", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_year":2020,"start_month":1,"end_year":2024,"end_month":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/month-counter", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "start_year": 2020,
  "start_month": 1,
  "end_year": 2024,
  "end_month": 6
}

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

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

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

تقبل هذه القدرة start_year وstart_month وend_year وend_month، وتتحقق من أن كل سنة عدد صحيح من 1 إلى 9999 وكل شهر عدد صحيح من 1 إلى 12، ثم تطبق الهوية months تساوي سنة النهاية ناقص سنة البداية، مضروبة في اثني عشر، زائد شهر النهاية ناقص شهر البداية. الفرق ذو الإشارة هو months؛ والقيمة المطلقة هي month_count. يفشل الشهر أو السنة غير الصالحين ب invalid_input ولا يُفوتران. يشغّل نفس وحدة الأعداد الصحيحة الخالصة ودجة المتصفح المجانية ومسار API، بلا ساعة نظام ولا شبكة ولا عشوائية.

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

يجب أن تقع السنوات بين 1 و9999 شمولًا. ويجب أن تقع الأشهر بين 1 و12 شمولًا. تُقبل السلاسل الرقمية مثل "2020" أو "06"؛ ولا تُقبل القيم المنطقية ولا الكائنات ولا السلاسل الفارغة ولا غير الأعداد الصحيحة. لا يقرأ المحرك ساعة النظام أبدًا، فيتلقى مستدعيان يرسلان الأعداد الأربعة نفسها دائمًا الكائن نفسه. أرسلوا أربعة أعداد صحيحة إلزامية: start_year وstart_month للحد الذي تعاملونه بداية، وend_year وend_month للحد الآخر. تُسقط الأسماء البديلة from_year وbegin_year وfrom_month وbegin_month وto_year وuntil_year وto_month وuntil_month على الحقول الأربعة نفسها حتى يستخدم نموذج أو نص الأسماء الموجودة أصلًا في مخططه. إذا كان لأي من التاريخين شهر أو سنة غير صالحين، تفشل المهمة ب invalid_input يسمي الحقل — ولا تُفوتر تلك الإخفاقات. عند النجاح يعيد الجسم الأعداد الصحيحة الأربعة بعد التحقق، ويعيد months فرقًا ذا إشارة، ويعيد month_count عدد الأشهر المطلق، ويعيد صياغة المعادلة ليطبع العميل الهوية بجانب الجواب. مثال: start_year 2020 وstart_month 1 وend_year 2024 وend_month 6 يعطيان months 53 وmonth_count 53، لأن أربع سنوات ثمانية وأربعون شهرًا ومن يناير إلى يونيو خمسة أشهر إضافية.

أين يثبت عداد الأشهر جدواه

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

أسئلة تقنية

كيف يحسب عداد الأشهر الأشهر الكاملة بين تاريخين؟

يأخذ start_year وstart_month وend_year وend_month ويعيد months = (end_year − start_year) × 12 + (end_month − start_month). وmonth_count هو القيمة المطلقة لذلك الفرق ذي الإشارة.

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

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

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

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

مثال محلول

معنى عدد الأشهر الكاملة بين تاريخين من نوع سنة-شهر

أين يثبت عداد الأشهر جدواه

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

آجال الإيجار والاستئجار

مدة الخدمة بالأشهر

نوافذ الاشتراك والمشروع

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

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

أين يثبت عداد الأشهر جدواه

أسئلة تقنية

شكرًا