API de Tempo Solar Verdadeiro
O relógio na parede e o sol sobre o local de nascimento são dois tempos diferentes, e numa zona horária extensa eles se afastam por horas. Este endpoint devolve o segundo, decomposto para que possas ver de onde vem cada minuto.
API de Tempo Solar Verdadeiro
O tempo solar verdadeiro é o ângulo horário do Sol aparente na longitude de nascimento, avançado meio dia, obtido a partir da ascensão reta aparente da Swiss Ephemeris em relação ao Greenwich mean sidereal time. Decompõe-se em dois termos que são reportados separadamente. O termo do meridiano é a distância do local de nascimento ao meridiano da sua zona, quatro minutos por grau, e é o maior: a China tem um desvio de Kashgar a Harbin, por isso um nascimento em Xinjiang fica quase três horas afastado do seu próprio relógio. A equação do tempo é a oscilação anual do Sol, até cerca de dezasseis minutos em cada sentido, e é o termo que as tabelas de almanaque normalmente omitem. A resposta também indica se a correção cruzou a meia-noite, pois isso move o pilar do dia e não só a 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 | Obrigatório | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sim | Local calendar date at birth. |
| time | string (HH:MM:SS) | sim | Local clock time at birth. |
| timezoneOffset | number (hours) | sim | 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 | sim | Birth longitude in decimal degrees, east positive. |
Quando usar
Usa-o sempre que um mapa dependa do duplo-horário e o local de nascimento esteja longe do meridiano da sua zona: pilares de hora BaZi, palácios de hora Zi Wei, qualquer leitura chinesa para um nascimento no oeste da China, numa zona extensa como Espanha ou Argentina, ou onde quer que uma fronteira de zona colonial esteja bem afastada do meridiano. Também serve como ferramenta autónoma para trabalhos com relógios de sol e para quem quer conciliar um almanaque impresso com a hora do relógio. Dentro da nossa própria superfície BaZi a mesma correção está disponível como a flag trueSolarTime, por isso raramente precisas de chamar este endpoint e depois reenviar o resultado.
Notas
A correção atinge o dia e a hora e deliberadamente não atinge o ano nem o mês. Li Chun e o 節 são instantes mundiais, e uma leitura de relógio de sol não tem nada a dizer sobre quando o Sol cruza 315 graus. Aplicar a correção ao limite do ano é um bug real e comum: gera um nascimento dezassete minutos após Li Chun do ano anterior e quatro pilares errados. A equação do tempo está ancorada nos quatro pontos de viragem publicados da curva anual e nos seus quatro zeros.
Experimente a API de Tempo solar verdadeiro
Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.