AstroWay/api v2.173.1 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/chinese/true-solar-time

API timp solar adevărat

Ceasul de pe perete și soarele de deasupra locului de naștere sunt două timpuri diferite, și într-o zonă largă se separă cu ore. Acest endpoint returnează al doilea, descompus ca să poți vedea de unde vine fiecare minut.

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

API timp solar adevărat

Timpul solar adevărat este unghiul orar al Soarelui aparent la longitudinea nașterii, rotit pe jumătate de zi, preluat din Swiss Ephemeris ascensiunea dreaptă aparentă față de Greenwich mean sidereal time. Se descompune în două termeni raportați separat. Termenul meridian este distanța locului de naștere de meridianul zonei, patru minute pe grad, și e cel mare: China are un decalaj de la Kashgar la Harbin, așa că o naștere în Xinjiang este aproape trei ore de ceasul propriu. Ecuația timpului e oscilația anuală a Soarelui, până la aproximativ șaisprezece minute în ambele sensuri, și e termenul pe care tabelele de almanah îl omite de obicei. Răspunsul raportează și dacă corecția a trecut la miezul nopții, pentru că atunci se mută pilonul zilei, nu doar 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

Folosește-l ori de câte ori o diagramă depinde de dublu-oră și locul de naștere e departe de meridianul zonei: pilonii de oră BaZi, palate de oră Zi Wei, orice lectură chineză pentru o naștere în vestul Chinei, într-o zonă largă ca Spania sau Argentina, sau oriunde o frontieră de zonă colonială e mult în afara meridianului. Mai servește și ca utilitar pentru lucrul cu cadrane solare și pentru oricine vrea să reconcilieze un almanah tipărit cu ora pe ceas. În suprafața noastră BaZi aceeași corecție e disponibilă ca flag trueSolarTime, așa că rareori trebuie să apelezi acest endpoint și apoi să retrimiți rezultatul.

// 05 / Notes

Notes

Corecția ajunge la zi și la oră și, intenționat, nu ajunge la an și lună. Li Chun și 節 sunt momente globale, și o lectură de cadran solar nu are nimic de spus despre când Soarele trece 315 grade. Aplicarea corecției la limita anului e o eroare reală și comună: dă o naștere cu șaptesprezece minute după Li Chun din anul precedent și patru piloni greșiți. Ecuația timpului e fixată pe cele patru puncte de cotitură publicate ale curbei anuale și pe cele patru zerouri.

Try the Timp solar adevărat API

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

99,9% SLA · planuri plătite · 30 zile status →