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

حساب طول السنة الهجرية: 354 أم 355 يوماً

تحدد هذه الحاسبة ما إذا كانت السنة في التقويم الإسلامي الجدولي تتألف من 354 أو 355 يوماً.

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

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

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

المقصود بالسنة الهجرية في هذه الحاسبة

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

كيفية حساب النتيجة 354 أو 355 يوماً

يضع الحساب أولاً السنة المدخلة في واحد من المواضع الثلاثين للدورة الجدولية. مواضع الكبس هي 2 و5 و7 و10 و13 و16 و18 و21 و24 و26 و29، وسائر المواضع سنوات عادية. ينتج عن موضع الكبس 355 يوماً، وعن الموضع العادي 354 يوماً. هذه عملية دقيقة على الأعداد الصحيحة وليست تقديراً لطور القمر. لا يستخدم التنفيذ كائن Date في JavaScript، ولا يقرأ ساعة النظام، ولا يجري طلباً شبكياً، ولا يعتمد على قاعدة بيانات للمناطق الزمنية. لذلك لا يمكن أن تغير UTC أو الإعدادات المحلية الإجابة. يجب أن يكون الإدخال عدداً صحيحاً موجباً وآمناً من النوع الرقمي؛ وتُرفض السلاسل الرقمية والكسور والصفر والسنوات السالبة والقيم اللانهائية والأعداد الصحيحة غير الآمنة بدلاً من تحويلها ضمنياً. يظهر موضع الدورة في المخرجات كي تتمكنوا من مراجعة القرار. وتفيد هذه القاعدة الواضحة أيضاً في اختبارات الوحدات والترحيل وفحوص التوافق بين لغات البرمجة.

اختيار نموذج التقويم المناسب لمهمتكم

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

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

التحقق من بيانات التقويم

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

إنشاء اختبارات حتمية

أنشئوا قيماً متوقعة وثابتة للبرامج التي تطبق دورة التقويم الإسلامي الجدولي نفسها ومدتها 30 سنة.

شرح بنية سنوات الكبس

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

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

هل تعطي جميع التقاويم الإسلامية هذه النتيجة؟

لا. تختص هذه الحاسبة بالتقويم الإسلامي الجدولي؛ وقد تستخدم التقاويم الرصدية والرسمية قواعد مختلفة.

ما مواضع سنوات الكبس في الدورة؟

مواضع الكبس في كل دورة من 30 سنة هي 2 و5 و7 و10 و13 و16 و18 و21 و24 و26 و29.

لماذا تتألف سنة الكبس الهجرية من 355 يوماً؟

يضيف النظام الجدولي يوماً إلى الشهر الأخير في سنوات الكبس المحددة، فيرتفع المجموع من 354 إلى 355.

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

لا. يستخدم الحساب أعداداً صحيحة وفق قاعدة ثابتة، من دون ساعة أو كائن Date أو منطقة زمنية أو خدمة خارجية.

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

تكلفة كل طلب API هي $0.002.

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

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

الـEndpoint

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

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

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

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

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

import os, requests

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

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

body := bytes.NewBufferString(`{"year":1446}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hijri-year-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
}

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

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