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.
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ę.
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
}' {
"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"
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| 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. |
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.
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ę.