API waktu matahari sejati

Waktu matahari sejati adalah sudut jam matahari tampak di bujur tempat lahir, dibawa setengah hari, diambil dari asensio kanan tampak Swiss Ephemeris terhadap waktu sideris rata-rata Greenwich. Ini terdekomposisi menjadi dua istilah yang dilaporkan terpisah. Istilah meridian adalah jarak tempat lahir dari meridian zonanya, empat menit per derajat, dan ini adalah yang besar: China memiliki satu perbedaan dari Kashgar hingga Harbin, sehingga kelahiran di Xinjiang hampir tiga jam dari jamnya sendiri. Persamaan waktu adalah getaran tahunan matahari itu sendiri, hingga sekitar enam belas menit ke arah mana pun, dan ini adalah istilah yang tabel almanak biasanya lewatkan. Respons juga melaporkan apakah koreksi menyeberang tengah malam, karena itu memindahkan pilar hari dan bukan hanya jam.

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
  }'

{
  "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"
  }
}

Gunakan kapan saja bagan bergantung pada jam ganda dan tempat lahir jauh dari meridian zonanya: pilar jam BaZi, istana jam Zi Wei, bacaan Tionghoa apa pun untuk kelahiran di barat Tiongkok, di zona luas seperti Spanyol atau Argentina, atau di mana pun batas zona era kolonial jauh dari meridian. Ini juga berdiri sendiri sebagai utilitas untuk pekerjaan jam matahari dan bagi siapa pun yang menyetarakan almanak tercetak dengan waktu jam. Di permukaan BaZi kami sendiri, koreksi yang sama tersedia sebagai bendera trueSolarTime, jadi Anda jarang perlu memanggil endpoint ini lalu mengirim ulang hasilnya.

Koreksi mencapai hari dan jam dan sengaja tidak mencapai tahun dan bulan. Li Chun dan 節 adalah momen dunia, dan bacaan jam matahari tidak mengatakan apa-apa tentang kapan matahari menyeberang 315 derajat. Menerapkan koreksi ke batas tahun adalah bug yang nyata dan umum: itu memberikan kelahiran tujuh belas menit setelah Li Chun tahun sebelumnya dan empat pilar yang salah. Persamaan waktu ditetapkan pada empat titik balik tahunan yang diterbitkan dan empat nolnya.