AstroWay/api v2.260.0 · de
alle Systeme in Ordnung
// astrology api · POST /v1/chinese/true-solar-time

Wahre Sonnenzeit API

Die Uhr an der Wand und die Sonne über dem Geburtsort sind zwei verschiedene Zeiten, und in einer weiten Zeitzone liegen sie stundenweise auseinander. Dieser Endpunkt liefert die zweite, zerlegt, sodass du sehen kannst, wo jede Minute herkommt.

Endpunkt
POST /v1/chinese/true-solar-time
Kosten
10 Credits
Latenz
~55 ms
Stufe
Tier 1
// 01 / Was es berechnet

Wahre Sonnenzeit API

Wahre Sonnenzeit ist der hour angle der apparent Sun am birth longitude, um einen halben Tag herumgetragen, genommen aus der Swiss Ephemeris apparent right ascension gegenüber Greenwich mean sidereal time. Sie zerlegt sich in zwei Terme, die separat gemeldet werden. Der Meridian-Term ist die Entfernung des Geburtsorts von seinem Zonenmeridian, vier Minuten pro Grad, und er ist der große: China hat einen Versatz von Kashgar nach Harbin, sodass eine Xinjiang-Geburt fast drei Stunden von ihrer eigenen Uhr entfernt liegt. Die equation of time ist die jährliche Schwankung der Sun, bis zu etwa sechzehn Minuten in beide Richtungen, und das ist der Term, den almanac tables meist weglassen. Die Antwort gibt auch an, ob die Korrektur über Mitternacht hinweg ging, da das den day pillar und nicht nur die hour verschiebt.

// 02 / Live-Anfrage

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
  }'
Antwort (Auszug)
{
  "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 / Parameter

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Local calendar date at birth.
time string (HH:MM:SS) ja Local clock time at birth.
timezoneOffset number (hours) ja 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 ja Birth longitude in decimal degrees, east positive.
// 04 / Wann verwenden

Wann verwenden

Benutze es, wann immer ein Chart von der double-hour abhängt und der Geburtsort weit vom Zonenmeridian entfernt ist: BaZi hour pillars, Zi Wei hour palaces, jede chinesische Lesung für eine Geburt im Westen Chinas, in einer weiten Zone wie Spanien oder Argentinien, oder überall, wo eine koloniale Zonen-grenze weit vom Meridian liegt. Es kann auch allein als Hilfsmittel für sundial-Arbeiten und für jeden dienen, der einen gedruckten almanac mit der clock time abgleicht. In unserer eigenen BaZi-Oberfläche ist dieselbe Korrektur als trueSolarTime-Flag verfügbar, sodass du selten diesen endpoint aufrufen und das Ergebnis erneut senden musst.

// 05 / Hinweise

Hinweise

Die Korrektur wirkt auf den day und die hour und lässt bewusst das year und den month außen vor. Li Chun und das 節 sind weltweite Zeitpunkte, und ein sundial-Ablesen sagt nichts darüber, wann die Sun 315 Grad kreuzt. Die Korrektur auf die year-Grenze anzuwenden ist ein echter und häufiger bug: sie ergibt eine Geburt siebzehn Minuten nach Li Chun im Vorjahr und vier falsche pillars. Die equation of time ist an die vier veröffentlichten turning points der jährlichen Kurve und deren vier zeros gebunden.

Wahre Sonnenzeit-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →