真太陽時 API

True solar time は、出生経度における見かけの太陽の時角で、半日分回転させたもの。Swiss Ephemeris の見かけの赤経と Greenwich mean sidereal time から算出するんだ。二つの項に分解され、別々に報告される。meridian 項は出生地とそのゾーン子午線との距離で、1度あたり4分で、これが大きい方だ。中国はカシュガルからハルビンまでオフセットがあり、Xinjiang の出生は自分の時計とほぼ3時間ずれる。equation of time は太陽自身の年周期の揺れで、最大約16分前後で、通常 almanac 表では省かれる項だ。response は補正が midnight を跨いだかどうかも報告する。これにより day pillar が変わり、hour だけでなくなるんだ。

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

チャートが二時間単位に依存し、出生地がゾーン子午線から遠いときに使うんだ。たとえば BaZi の時柱、Zi Wei の時宮、西部中国での出生、スペインやアルゼンチンのような広いゾーン、植民地時代のゾーン境界が子午線からずれている場所などだ。 sundial の作業や印刷された almanac と時計時間を合わせる人にも単体のユーティリティとして使える。自分たちの BaZi 表面では同じ補正が trueSolarTime フラグとして利用できるから、ほとんどこの endpoint を呼んで結果を再送する必要はないよ。

補正は day と hour まで届くが、year と month にはわざと及ばないんだ。Li Chun と 節 は世界的な瞬間で、sundial の読み取りは太陽が315度を通過する時については何も言えない。year の境界に補正を適用すると実際によくあるバグで、前年の Li Chun の 17分後に出生がずれ、4つの柱が間違うんだ。equation of time は年周期の曲線の4つの公表された転換点と4つのゼロ点に固定されている。