AstroWay/api v2.173.1 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/chinese/true-solar-time

الوقت الشمسي الحقيقي API

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

Endpoint
POST /v1/chinese/true-solar-time
Cost
10 credits
Latency
~55 ms
Tier
Tier 1
// 01 / What it computes

الوقت الشمسي الحقيقي API

الوقت الشمسي الحقيقي هو زاوية الساعة للشمس الظاهرة عند خط الطول للولادة، تُدور بنصف يوم، مأخوذة من الـ Swiss Ephemeris للارتفاع الظاهري مقابل توقيت جرينتش النجمي المتوسط. يتقسم إلى مصطلحين يُبلغ عنهما منفصلين. مصطلح المرصد هو مسافة مكان الميلاد من مرصد منطقته، أربع دقائق لكل درجة، وهو الأكبر: الصين عندها فرق من كاشغار إلى هاربين، فمولود في شينجيانغ يكون تقريباً ثلاث ساعات بعيد عن ساعته. الـ equation of time هو تذبذب الشمس السنوي، يصل إلى حوالي ستة عشر دقيقة في أي اتجاه، وهو المصطلح اللي عادةً الجداول almanac تتجاهله. الاستجابة كمان تُظهر إذا كان التصحيح عبر منتصف الليل، لأن هذا يغيّر عمود اليوم مش بس الساعة.

// 02 / Live request

POST/v1/chinese/true-solar-time

curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 8,
    "longitude": 87.6
  }'
Response (excerpt)
{
  "ok": true,
  "data": {
    "clockTime": "14:30:00",
    "trueSolarTime": "12:24:06",
    "totalCorrectionMinutes": -125.89,
    "longitudeCorrectionMinutes": -129.6,
    "equationOfTimeMinutes": 3.71,
    "dayShift": 0,
    "date": "1990-05-15"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Local calendar date at birth.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes The offset the clock was actually running on. A 1988 Beijing birth ran on +9 under summer time, and no arithmetic here recovers that from the date.
longitude number yes Birth longitude in decimal degrees, east positive.
// 04 / When to use it

When to use it

استخدمه كل ما المخطط يعتمد على الـ double-hour ومكان الميلاد بعيد عن مرصد منطقته: أعمدة ساعة BaZi، قصور ساعة Zi Wei، أي قراءة صينية لميلاد في غرب الصين، أو في منطقة واسعة زي إسبانيا أو الأرجنتين، أو أي مكان حدود المنطقة الاستعمارية فيه بعيد عن المرصد. كمان يشتغل كأداة مستقلة لعمل المِشْرَاة الشمسية ولأي شخص يطابق almanac مطبوع مع وقت الساعة. داخل BaZi عندنا نفس التصحيح متوفر كعلامة trueSolarTime، فغالباً ما تحتاج تستدعي هذا endpoint وتعيد إرسال النتيجة.

// 05 / Notes

Notes

التصحيح يوصل للنهار والساعة ومتعمد ما يوصلش للسنة والشهر. Li Chun و الـ 節 هم لحظات عالمية، وقراءة المشْرَاة ما لهاش علاقة بموعد عبور الشمس 315 درجة. تطبيق التصحيح على حد السنة هو خطأ شائع وحقيقي: يعطي ميلاد بعد سبع عشرة دقيقة من Li Chun السنة اللي فاتت وأربع أعمدة غلط. الـ equation of time مربوط بأربع نقاط تحول منشورة للمنحنى السنوي وأربع أصفار له.

Try the الوقت الشمسي الحقيقي API

Grab a key and make your first call in under a minute.

99.9% SLA · الخطط المدفوعة · 30d الحالة →