API de l'heure solaire vraie

L'heure solaire vraie est l'angle horaire du Soleil apparent à la longitude de naissance, décalé d'une demi-journée, tiré de l'ascension droite apparente de la Swiss Ephemeris par rapport au temps sidéral moyen de Greenwich. Elle se décompose en deux termes qui sont rapportés séparément. Le terme méridien est la distance du lieu de naissance par rapport à son méridien de zone, quatre minutes par degré, et c'est le plus important : la Chine utilise un seul décalage de Kashgar à Harbin, donc une naissance au Xinjiang est à près de trois heures de sa propre horloge. L'équation du temps est la propre oscillation annuelle du Soleil, jusqu'à environ seize minutes dans un sens ou dans l'autre, et c'est le terme que les tables d'almanach omettent généralement. La réponse indique également si la correction a franchi minuit, car cela déplace le pilier du jour et pas seulement l'heure.

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"
  }
}

Utilisez-le chaque fois qu'une carte dépend de la double-heure et que le lieu de naissance est éloigné de son méridien de zone : piliers horaires BaZi, palais horaires Zi Wei, toute lecture chinoise pour une naissance en Chine occidentale, dans une zone large comme l'Espagne ou l'Argentine, ou partout où une limite de zone de l'ère coloniale est bien éloignée du méridien. Il sert également d'utilitaire autonome pour le travail sur les cadrans solaires et pour quiconque réconcilie un almanach imprimé avec l'heure de l'horloge. Au sein de notre propre interface BaZi, la même correction est disponible sous forme de drapeau trueSolarTime, vous avez donc rarement besoin d'appeler cet endpoint puis de renvoyer le résultat.

La correction atteint le jour et l'heure et ne s'applique délibérément pas à l'année et au mois. Li Chun et les 節 sont des instants mondiaux, et une lecture de cadran solaire n'a rien à dire sur le moment où le Soleil traverse 315 degrés. Appliquer la correction à la limite de l'année est un bug réel et courant : cela donne une naissance dix-sept minutes après Li Chun de l'année précédente et quatre piliers erronés. L'équation du temps est fixée aux quatre points de virage publiés de la courbe annuelle et à ses quatre zéros.