AstroWay/api v2.260.0 · pl
wszystkie systemy w normie
// astrology api · POST /v1/chinese/true-solar-time

API prawdziwego czasu słonecznego

Zegar na ścianie i słońce nad miejscem urodzenia to dwa różne czasy, a w szerokiej strefie czasowej różnią się o godziny. Ten endpoint zwraca ten drugi, rozłożony tak, abyś mógł zobaczyć, skąd wzięła się każda minuta.

Endpoint
POST /v1/chinese/true-solar-time
Koszt
10 kredytów
Opóźnienie
~55 ms
Poziom
Tier 1
// 01 / Co oblicza

API prawdziwego czasu słonecznego

Prawdziwy czas słoneczny to kąt godzinowy Słońca pozornego na długości geograficznej urodzenia, przesunięty o pół dnia, zaczerpnięty z pozornego wzniesienia prostego Swiss Ephemeris względem średniego czasu gwiazdowego Greenwich. Rozkłada się na dwa człony, które są raportowane oddzielnie. Człon południkowy to odległość miejsca urodzenia od południka strefowego, cztery minuty na stopień, i jest to ten duży: Chiny stosują jedno przesunięcie od Kaszgaru do Harbinu, więc urodzenie w Xinjiangu jest oddalone o prawie trzy godziny od własnego zegara. Równanie czasu to roczne wahanie samego Słońca, do około szesnastu minut w każdą stronę, i jest to termin, który tabele almanachów zazwyczaj pomijają. Odpowiedź raportuje również, czy korekta przekroczyła północ, ponieważ to przesuwa filar dnia, a nie tylko godzinę.

// 02 / Zapytanie na żywo

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
  }'
Odpowiedź (fragment)
{
  "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 / Parametry

Parametry

nametypeWymagane
date string (YYYY-MM-DD) tak Local calendar date at birth.
time string (HH:MM:SS) tak Local clock time at birth.
timezoneOffset number (hours) tak 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 tak Birth longitude in decimal degrees, east positive.
// 04 / Kiedy używać

Kiedy używać

Używaj go zawsze, gdy wykres zależy od podwójnej godziny, a miejsce urodzenia jest daleko od południka strefowego: filary godzinowe BaZi, pałace godzinowe Zi Wei, dowolne chińskie odczyty dla urodzenia w zachodnich Chinach, w szerokiej strefie, takiej jak Hiszpania czy Argentyna, lub wszędzie tam, gdzie granica strefy z epoki kolonialnej znajduje się daleko od południka. Służy również jako samodzielne narzędzie do pracy z zegarami słonecznymi i dla każdego, kto porównuje drukowany almanach z czasem zegarowym. W naszej własnej powierzchni BaZi ta sama korekta jest dostępna jako flaga trueSolarTime, więc rzadko musisz wywoływać ten endpoint, a następnie ponownie wysyłać wynik.

// 05 / Uwagi

Uwagi

Korekta dotyczy dnia i godziny i celowo nie dotyczy roku i miesiąca. Li Chun i 節 to światowe momenty, a odczyt z zegara słonecznego nie ma nic do powiedzenia na temat tego, kiedy Słońce przekracza 315 stopni. Stosowanie korekty do granicy roku jest prawdziwym i powszechnym błędem: daje urodzenie siedemnaście minut po Li Chun w poprzednim roku i cztery błędne filary. Równanie czasu jest przypięte do czterech opublikowanych punktów zwrotnych rocznej krzywej i jej czterech zer.

Wypróbuj API Prawdziwy czas słoneczny

Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.

99.9% SLA · plany płatne · 30d status →