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

تقدير طور القمر لأي تاريخ

تحوّل هذه الأداة تاريخاً تقويمياً واحداً إلى وصف عملي لدورة القمر، مثل المحاق أو الهلال المتزايد أو التربيع الأول أو البدر أو الهلال المتناقص.

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

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

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

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

أدخل تاريخاً ميلادياً كاملاً

أدخل التاريخ حصراً بالصيغة YYYY-MM-DD، مع وضع صفر في البداية عندما يكون الشهر أو اليوم من رقم واحد. فعلى سبيل المثال، يُكتب 8 أبريل 2024 بالشكل 2024-04-08. تتحقق الأداة من صحة التاريخ في التقويم الميلادي الفعلي، وليس من هيئة النص وحدها، ولذلك ترفض القيم المستحيلة مثل 30 فبراير. وتطبّق على السنوات الكبيسة قاعدة القسمة على أربعة مع استثناء سنوات القرون وتصحيح الأربعمئة سنة. يُجرى الحساب عند ظهر التاريخ المطلوب بالتوقيت العالمي المنسق. ويمنح ذلك كل يوم نقطة تقييم ثابتة، كما يمنع اعتماد النتيجة بصورة خفية على المنطقة الزمنية المحلية للحاسوب. تقبل الأداة السنوات من 0001 إلى 9999 عندما تُمثّل بأربعة أرقام. ولا تفسر العبارات غير الرسمية أو ترتيبات التاريخ الإقليمية أو الطوابع الزمنية أو لواحق المناطق الزمنية. حوّل هذه القيم إلى الصيغة الموثقة قبل إرسال الطلب. تجعل قواعد الإدخال الصارمة استدعاءات API قابلة للتكرار، وتمنع تفسير تاريخ ملتبس مثل 03/04/2025 بطرائق مختلفة بين الأنظمة.

افهم طريقة احتساب التقدير

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

استخدم النتيجة بمستوى الدقة المناسب

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

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

إضافة طور القمر إلى التقويم

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

التخطيط للتصوير الليلي العام

قارن التواريخ حسب الإضاءة المقدرة قبل التحقق من المواقيت المحلية والطقس.

شرح الدورة القمرية

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

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

ما مدى دقة تقدير الطور؟

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

أي وقت من اليوم يستخدمه الحساب؟

يقيّم الحساب التاريخ المدخل عند 12:00 UTC كي لا تعتمد النتيجة على المنطقة الزمنية المحلية.

هل تحسب الأداة شروق القمر أو غروبه؟

لا. تتطلب هذه المواقيت تحديد الموقع واستخدام نموذج فلكي أكثر تفصيلاً.

ما صيغة التاريخ المقبولة؟

استخدم الصيغة YYYY-MM-DD تماماً مع شهر ويوم صالحين في التقويم الميلادي، مثل 2024-04-08.

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

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن تشغيل نسخة المتصفح محلياً من دون استدعاء API.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/misc2/moon-phase-estimate

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

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

curl -X POST https://api.kit.forhosting.com/misc2/moon-phase-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-04-08"}'

const res = await fetch("https://api.kit.forhosting.com/misc2/moon-phase-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-04-08"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/misc2/moon-phase-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-04-08"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-04-08"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/moon-phase-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2024-04-08"
}

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

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