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

حاسبة وقت الغروب

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

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

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

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

تقيّم هذه الحاسبة المتطابقة الهندسية cos ω يساوي ناقص tan φ في tan δ، ثم تحوّل زاوية ساعة الغروب ω إلى ساعات عشرية بعد الظهر الشمسي، وتضيف إزاحة النطاق الزمني لتنتج توقيتًا محليًا بالساعات العشرية. عندما يتجاوز حاصل ضرب الظلين واحدًا لا تغرب الشمس — شمس منتصف الليل — فتفشل المهمة بالرمز invalid_input بدل اختراع توقيت ساعة. تُرفض الليلة القطبية، حيث لا تشرق الشمس، للسبب نفسه: لا غروب يُبلَّغ. بلا مراجعة تقويم ولا شبكة ولا جدول معادلة الزمن: تقدّمون الزوايا والإزاحة، وتجري الدالة الصرف نفسها في widget المجاني بالمتصفح وفي مسار API عند $0.002 لكل طلب ناجح.

طريقة الاستخدام

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

راجع بياناتك

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

أعد الحساب أو نفّذه آليًا

استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.

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

احصل على النتيجة الآن

أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.

قارن السيناريوهات

غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.

أتمت العمل المتكرر

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

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

كيف يُحسب وقت الغروب المحلي من خط العرض والميل؟

تستوفي زاوية الساعة الهندسية cos ω = −tan φ tan δ. الغروب الشمسي هو 12 + ω°/15 ساعات عشرية. إضافة tz_offset والطيّ على [0, 24) تعطي التوقيت المحلي الذي تعيده هذه الحاسبة.

ماذا يحدث إن لم تغرب الشمس؟

تفشل المهمة بالرمز invalid_input. ليس لشمس منتصف الليل ساعة غروب تُبلَّغ، فلا تخترع API القيمة 24.00 ولا نجاحًا أجوف. وتُرفض الليلة القطبية للسبب نفسه: لا غروب حين لا يشرق القرص.

هل يشمل tz_offset خط الطول أو معادلة الزمن؟

لا. tz_offset ساعات تُضاف إلى الزمن الشمسي الظاهري. خط الطول ومعادلة الزمن والانكسار المدني (المعتاد −0.833°) خارج هذا العقد الهندسي ذي المدخلات الثلاث.

ماذا تعني ساعة غروب عشرية؟

sunset_hours قيمة ساعة على مدار 24 ساعة بالساعات العشرية: 18.5 هي 18:30 و19.25 هي 19:15. تُطوى القيم على [0, 24) عندما تدفع إزاحة كبيرة مساءً شمسيًا إلى صباح مدني تالٍ.

كم تكلفة حاسبة وقت الغروب؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/phys/sunset

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

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

curl -X POST https://api.kit.forhosting.com/phys/sunset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/phys/sunset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/phys/sunset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/phys/sunset", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

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

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