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

حساب طول النهار حسب التاريخ وخط العرض

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

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

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

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

أدخلوا تاريخاً دقيقاً وخط العرض الجغرافي

اكتبوا التاريخ بصيغة ISO الصارمة، بأربعة أرقام للسنة ورقمين لكل من الشهر واليوم، مثل 2026-06-21. ثم أدخلوا خط عرض عشرياً من -90 إلى 90؛ فالقيم الموجبة شمال خط الاستواء والسالبة جنوبه. لا حاجة إلى خط الطول أو المنطقة الزمنية لأن المطلوب هو المدة بين الشروق والغروب النظريين، لا توقيتهما المحلي. تتحقق الحاسبة من التقويم الغريغوري وقواعد السنوات الكبيسة، وترفض التواريخ المستحيلة. كما تحسب ترتيب اليوم حسابياً فقط، ولذلك تعطي المدخلات نفسها النتيجة نفسها في كل بيئة. اختاروا خط عرض ممثلاً للموقع، ولا تعدّوا كثرة المنازل العشرية بديلاً عن دقة الرصد الفلكي.

افهموا طريقة التقريب الشمسي

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

استخدموا النتيجة ضمن حدودها المناسبة

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

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

مقارنة الضوء بين الفصول

احسبوا عدة تواريخ عند خط العرض نفسه لمتابعة التغير من الشتاء إلى الصيف.

تخطيط الأنشطة الخارجية

قدّروا نافذة الضوء المتاحة للسفر أو التصوير أو البناء أو الزراعة أو العمل الميداني.

إثراء بيانات التقويم

أضيفوا مدة تقريبية قابلة للتكرار وحالة قطبية إلى السجلات الجغرافية المؤرخة.

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

ما تكلفة العملية الواحدة؟

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

لماذا لا يُطلب خط الطول؟

يغير خط الطول توقيت الشروق والغروب، لكنه لا يغير تقريباً المدة بينهما لتاريخ وخط عرض محددين.

هل هذه جداول فلكية دقيقة؟

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

كيف تُعالج السنوات الكبيسة؟

تطبق القواعد الغريغورية: السنة القابلة للقسمة على أربعة كبيسة، باستثناء القرون غير القابلة للقسمة على 400.

ماذا يعني النهار القطبي والليل القطبي؟

يعنيان أن المعادلة لا تجد غروباً أو شروقاً اصطلاحياً، فتنتج 24 ساعة أو صفر ساعة من الضوء.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/day-length-approx

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

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

curl -X POST https://api.kit.forhosting.com/date/day-length-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-06-21","lat":51.5074}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/day-length-approx",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-06-21",
    "lat": 51.5074
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-06-21","lat":51.5074}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/day-length-approx", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2026-06-21",
  "lat": 51.5074
}

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

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