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

حساب طول الشهر الهجري

تعيد هذه الحاسبة عدد أيام سنة وشهر محددين وفق التقويم الإسلامي الهجري الجدولي. أدخلوا سنة هجرية تبدأ من 1 AH ورقم شهر من 1 إلى 12.

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

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

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

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

ما الذي توضحه هذه الحاسبة

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

كيفية إجراء الحساب الجدولي

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

اختاروا اصطلاح التقويم قبل اعتماد النتيجة

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

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

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

حددوا أكبر يوم مقبول لسنة وشهر هجريين قبل حفظ نموذج أو استيراد السجلات.

إنشاء منتقي تاريخ حتمي

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

إعداد اختبارات تقويم قابلة للتكرار

أنشئوا نتائج متوقعة ثابتة للسنوات العادية والكبيسة في البرمجيات التي تطبق التقويم الإسلامي الجدولي صراحة.

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

ما تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكنكم أيضاً إجراء حساب فردي في المتصفح.

هل يعتمد الحساب على رؤية الهلال؟

لا. فهو يستخدم التقويم الإسلامي الجدولي الحتمي ولا يرجع إلى عمليات الرصد أو الإعلانات.

لماذا قد يعرض تقويم هجري آخر طولاً مختلفاً للشهر؟

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

كيف يعالج الشهر الثاني عشر؟

يتكون الشهر 12 من تسعة وعشرين يوماً في السنة الجدولية العادية ومن ثلاثين يوماً في السنة الجدولية الكبيسة.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/hijri-month-length

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

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

curl -X POST https://api.kit.forhosting.com/date/hijri-month-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1446,"month":12}'

const res = await fetch("https://api.kit.forhosting.com/date/hijri-month-length", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 1446,
    "month": 12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/hijri-month-length",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1446,
    "month": 12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/hijri-month-length", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":1446,"month":12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":1446,"month":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hijri-month-length", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "year": 1446,
  "month": 12
}

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

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