AstroWay/api v2.248.0 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/chinese/true-solar-time

API tempo solare vero

L'orologio sul muro e il sole sul luogo di nascita sono due orari diversi, e in un fuso orario ampio si discostano di ore. Questo endpoint restituisce il secondo, scomposto in modo da poter vedere da dove provenga ogni minuto.

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

API tempo solare vero

Il tempo solare vero è l'angolo orario del Sole apparente alla longitudine di nascita, portato avanti di mezzo giorno, preso dall'ascensione retta apparente dell'Ephemeris Svizzera rispetto al tempo siderale medio di Greenwich. Si scompone in due termini che vengono riportati separatamente. Il termine del meridiano è la distanza del luogo di nascita dal suo meridiano di zona, quattro minuti per grado, ed è il più grande: la Cina ha un offset da Kashgar a Harbin, quindi una nascitura nello Xinjiang si trova quasi tre ore lontana dal suo orologio. L'equazione del tempo è la propria oscillazione annuale del Sole, fino a circa sedici minuti in un senso o nell'altro, ed è il termine che le tavole degli almanacchi omettono solitamente. La risposta riporta anche se la correzione ha attraversato mezzanotte, poiché questo sposta il pilastro del giorno e non solo l'ora.

// 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

Usalo quando un grafico dipende dall'ora doppia e il luogo di nascita è lontano dal suo meridiano di zona: pil delle ore BaZi, palazzi delle ore Zi Wei, qualsiasi lettura cinese per una nascita nella Cina occidentale, in un fuso ampio come la Spagna o l'Argentina, o ovunque un confine di zona dell'era coloniale si trovi ben lontano dal meridiano. Può anche essere usato come strumento autonomo per il lavoro con gli orologi solari e per chiunque debba conciliare un almanacco stampato con l'orario. All'interno della nostra interfaccia BaZi la stessa correzione è disponibile come flag trueSolarTime, quindi raramente è necessario chiamare questo endpoint e poi reinviare il risultato.

// 05 / Notes

Notes

La correzione raggiunge il giorno e l'ora e deliberatamente non raggiunge l'anno e il mese. Li Chun e i 節 sono istanti mondiali, e una lettura di orologio solare non ha nulla da dire sul momento in cui il Sole attraversa i 315 gradi. Applicare la correzione al confine dell'anno è un errore reale e comune: dà una nascita di diciassette minuti dopo Li Chun dell'anno precedente e quattro pilastri sbagliati. L'equazione del tempo è ancorata ai quattro punti di svolta pubblicati della curva annuale e ai suoi quattro zeri.

Try the Tempo solare vero API

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

99.9% SLA · piani a pagamento · 30d stato →