Metafísica chinesa: perguntas frequentes

Porque é que a tua calculadora dá pilares diferentes de outra?

Quase sempre a causa é uma de quatro, e nenhuma delas é um erro. É uma escolha de escola que a maioria das calculadoras faz em silêncio. As nossas respostas e a execução sobre um dataset externo estão na página de convenções.

Eixo	A nossa resposta
Limite do ano	立春 Lichun, o momento exato a partir das efemérides
Limite do dia	23:00, o 子時 inicial pertence ao dia seguinte
Hora solar verdadeira	desligada por omissão, ativa-se com uma flag
Hora de verão	resolvida pelo timezoneOffset que envias

O ano começa no Ano Novo chinês ou no Lichun?

No Lichun, e as duas datas afastam-se todos os anos duas a três semanas. O Ano Novo chinês é o início do ano lunar e das festividades; os pilares constroem-se sobre o ano solar, que é aberto pelo Lichun. Quem nasceu a 10 de fevereiro de 2026 já pertence ao Cavalo pelos pilares, embora o Ano Novo tenha sido a 17 de fevereiro.

/v1/chinese/lunar-date devolve chineseNewYear num campo separado precisamente porque é outra grandeza, não um sinónimo.

O que enviar se a hora de nascimento for desconhecida?

Não envies time de todo. Três dos quatro pilares são calculados, e o da hora simplesmente não aparece. É mais honesto do que pôr o meio-dia: uma hora inventada dá um pilar da hora que parece um facto e não o é, e arrasta consigo os 神煞 que dependem dele.

O que muda sem a hora:

• o pilar da hora está ausente
• o animal secreto está ausente
• o equilíbrio dos elementos conta seis caracteres em vez de oito
• a força do mestre do dia desloca-se, porque desaparece um quarto do mapa

Quando ativar trueSolarTime?

Quando o local de nascimento está longe do meridiano do seu fuso horário. A China, de Kashgar a Harbin, vive toda em UTC+8, e em Xinjiang a diferença chega a três horas, ou seja, uma hora dupla e meia. A flag desloca o dia e a hora, e de propósito não desloca o ano nem o mês: o Lichun é um momento mundial, e a leitura de um relógio de sol nada tem a ver com ele.

curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":8,"longitude":87.6}'

Porque é que os vossos 藏干 estão por outra ordem que no livro?

A ordem na nossa lista segue os dias do 人元司令, ou seja, a ordem em que os troncos ocultos governam o mês. O papel (principal, middle, residual) vem num campo separado e não depende da posição. Nos quatro ramos-armazém 丑辰未戌, o papel intermédio pertence ao elemento que o ramo armazena, e não ao segundo elemento da lista. É o ponto em que as implementações públicas mais divergem.

Calculam o Zi Wei Dou Shu?

Sim. POST /v1/ziwei/chart constrói o mapa completo: os palácios da Vida e do Corpo a partir do mês lunar e da hora dupla, o 五行局 a partir do pilar do palácio da Vida, 紫微 pela regra da divisão com empréstimo, as restantes treze estrelas principais, seis auspiciosas e seis nefastas, trinta e uma menores, as doze fases, os ciclos 博士, 將前 e 歲前, os limites decenais e o anual, com os 四化 marcados diretamente nas estrelas.

As onze rotas /ziwei/* continuam a ser tabelas de referência de palácios e estrelas. Trazem o campo computed: false, custam metade da tarifa e devolvem o mesmo para qualquer data: são um dicionário, e é isso que dizem. /ziwei/full-chart está obsoleto até 2027-11-26 em favor de /ziwei/chart.

Detalhes e verificação: Zi Wei Dou Shu.

Em que são melhores do que uma biblioteca gratuita?

Em nada, se só precisas dos pilares. O lunar-typescript, sob licença MIT, calcula-os no teu processo, offline, sem limites de frequência, e não te aconselhamos a pagar por aquilo que podes não comprar.

A diferença começa depois: 神煞, interações dos ramos 刑冲合害, avaliação da força do mestre do dia, hora solar verdadeira, estrelas voadoras por assento e fachada, número Kua, escolha de data pelo Tong Shu. E 21 idiomas para tudo isto. Mais aquilo por que normalmente se paga de facto: uma única convenção para uma equipa que tem PHP no site, JavaScript na aplicação e Python nos crons.

Porque é que os nomes dos animais estão em inglês e os troncos em pinyin?

Os animais e os elementos têm nomes consagrados em cada língua, por isso são traduzidos: 午 é Caballo em espanhol e ウマ em japonês. Os troncos, os ramos, os 納音 e os nomes das estrelas não têm nomes consagrados, e o seu nome internacional é o pinyin ao lado do carácter. Inventar uma palavra checa para 甲 seria pior do que deixar 甲. A mesma regra aplica-se ao bloco de Human Design.

Que intervalo de datas aceitam?

Anos de 2 a 2899. O calendário é derivado das efemérides, por isso funciona muito para lá das tabelas impressas, mas não sem limites: sair do domínio devolve 400 com o nome do campo, não 500.

{ "ok": false, "error": { "code": "INVALID_INPUT",
  "message": "Validation failed: year: Too big: expected number to be <=2899" } }