API de tiempo solar verdadero
El reloj en la pared y el sol sobre el lugar de nacimiento son dos tiempos diferentes, y en una zona horaria amplia se separan por horas. Este endpoint devuelve el segundo, desglosado para que veas de dónde viene cada minuto.
API de tiempo solar verdadero
El tiempo solar verdadero es el ángulo horario del Sol aparente en la longitud de nacimiento, trasladado medio día, tomado de la ascensión recta aparente de la Swiss Ephemeris frente al tiempo sidéreo medio de Greenwich. Se descompone en dos términos que se informan por separado. El término meridiano es la distancia del lugar de nacimiento a su meridiano de zona, cuatro minutos por grado, y es el grande: China tiene un desfase de Kashgar a Harbin, así que un nacimiento en Xinjiang está casi a tres horas de su propio reloj. La ecuación del tiempo es la oscilación anual del Sol, hasta unos dieciséis minutos en cualquier dirección, y es el término que suelen omitir las tablas de almanaque. La respuesta también indica si la corrección cruzó la medianoche, ya que eso mueve el pilar del día y no solo la hora.
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"
}
}Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Local calendar date at birth. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | 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 | sí | Birth longitude in decimal degrees, east positive. |
Cuándo usarlo
Úsalo siempre que una carta dependa de la doble hora y el lugar de nacimiento esté lejos de su meridiano de zona: pilares de hora BaZi, palacios de hora Zi Wei, cualquier lectura china para un nacimiento en el oeste de China, en una zona amplia como España o Argentina, o donde la frontera zonal de la época colonial esté muy alejada del meridiano. También sirve por sí solo como herramienta para trabajos de relojes de sol y para quien quiera reconciliar un almanaque impreso con la hora del reloj. Dentro de nuestra propia superficie BaZi la misma corrección está disponible como bandera trueSolarTime, así que rara vez necesitas llamar a este endpoint y volver a enviar el resultado.
Notas
La corrección llega al día y a la hora y deliberadamente no llega al año ni al mes. Li Chun y el 節 son instantes mundiales, y una lectura de reloj de sol no dice nada sobre cuándo el Sol cruza los 315 grados. Aplicar la corrección al límite del año es un error real y frecuente: produce un nacimiento diecisiete minutos después de Li Chun del año anterior y cuatro pilares incorrectos. La ecuación del tiempo está anclada a los cuatro puntos de inflexión publicados de la curva anual y a sus cuatro ceros.
Prueba la API de Tiempo solar verdadero
Consigue una clave y haz tu primera llamada en menos de un minuto.