Metafísica china: preguntas frecuentes

¿Por qué tu calculadora da pilares distintos de los de otra?

Casi siempre la causa es una de estas cuatro, y ninguna es un error. Es una elección de escuela que la mayoría de las calculadoras hace en silencio. Nuestras respuestas y la ejecución contra un dataset externo están en la página de convenciones.

Eje	Nuestra respuesta
Límite del año	立春 Lichun, el instante exacto según las efemérides
Límite del día	23:00, el 子時 temprano pertenece al día siguiente
Hora solar verdadera	desactivada por defecto, se activa con un flag
Horario de verano	lo resuelve el timezoneOffset que envías

¿El año empieza con el Año Nuevo chino o con Lichun?

Con Lichun, y estas dos fechas se separan cada año dos o tres semanas. El Año Nuevo chino es el comienzo del año lunar y de las fiestas; los pilares se construyen sobre el año solar, que abre Lichun. Quien nació el 10 de febrero de 2026 ya pertenece al Caballo según los pilares, aunque el Año Nuevo fue el 17 de febrero.

/v1/chinese/lunar-date devuelve chineseNewYear en un campo aparte precisamente porque es otra magnitud, no un sinónimo.

¿Qué enviar si no se conoce la hora de nacimiento?

No envíes time en absoluto. Se calcularán tres de los cuatro pilares, y el de la hora simplemente no aparecerá. Es más honesto que poner el mediodía: una hora inventada da un pilar de la hora que parece un hecho sin serlo, y arrastra los 神煞 que dependen de él.

Qué cambia sin la hora:

• falta el pilar de la hora
• falta el animal secreto
• el balance de elementos se calcula sobre seis caracteres en lugar de ocho
• la fuerza del maestro del día se desplaza, porque desaparece un cuarto de la carta

¿Cuándo activar trueSolarTime?

Cuando el lugar de nacimiento está lejos del meridiano de su huso horario. China, de Kashgar a Harbin, vive con un único UTC+8, y en Xinjiang la diferencia llega a tres horas, es decir, hasta hora y media de reloj chino (shichen). El flag desplaza el día y la hora, y a propósito no desplaza el año ni el mes: Lichun es un instante universal y la lectura de un reloj de sol no tiene nada que ver con él.

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

¿Por qué vuestros 藏干 están en otro orden que en el libro?

El orden de nuestra lista sigue los días de 人元司令, es decir, el orden en que los troncos ocultos rigen el mes. El rol (principal, middle, residual) va en un campo aparte y no depende de la posición. En las cuatro ramas almacén 丑辰未戌, el rol intermedio corresponde al elemento que la rama almacena, no al segundo elemento de la lista. Es el punto en el que las implementaciones públicas divergen con más frecuencia.

¿Calculáis Zi Wei Dou Shu?

Sí. POST /v1/ziwei/chart construye la carta completa: los palacios de la Vida y del Cuerpo a partir del mes lunar y la hora china, el 五行局 a partir del pilar del palacio de la Vida, 紫微 según la regla de división con préstamo, las otras trece estrellas principales, seis auspiciosas y seis nefastas, treinta y una menores, las doce etapas, los ciclos 博士, 將前 y 歲前, los límites decenales y el anual, con los 四化 marcados directamente sobre las estrellas.

Las once rutas /ziwei/* siguen siendo tablas de referencia de palacios y estrellas. Llevan el campo computed: false, cuestan la mitad de la tarifa y devuelven lo mismo para cualquier fecha: son un diccionario, y así lo indican. /ziwei/full-chart está deprecado hasta 2027-11-26 en favor de /ziwei/chart.

Detalles y verificación: Zi Wei Dou Shu.

¿En qué sois mejores que una biblioteca gratuita?

En nada, si solo necesitas los pilares. lunar-typescript, bajo licencia MIT, los calcula en tu propio proceso, offline, sin límites de frecuencia, y no te aconsejamos pagar por lo que no hace falta comprar.

La diferencia empieza después: 神煞, las interacciones entre ramas 刑冲合害, la valoración de la fuerza del maestro del día, la hora solar verdadera, las estrellas voladoras por asiento y fachada, el número Kua, la elección de fecha Tong Shu. Y 21 idiomas para todo ello. Más aquello por lo que normalmente se paga de verdad: una sola convención para un equipo que tiene PHP en el sitio web, JavaScript en la aplicación y Python en los cron.

¿Por qué los animales van traducidos y los troncos en pinyin?

Los animales y los elementos tienen nombres establecidos en cada idioma, así que se traducen: 午 es Caballo en español y ウマ en japonés. Los troncos, las ramas, los 納音 y los nombres de las estrellas no tienen nombres establecidos, y su nombre internacional es el pinyin junto al carácter. Inventar una palabra checa para 甲 sería peor que dejar 甲. La misma regla se aplica en el bloque de Human Design.

¿Qué rango de fechas aceptáis?

Los años del 2 al 2899. El calendario se deriva de las efemérides, por lo que funciona mucho más allá de las tablas impresas, pero no sin límite: salir del dominio devuelve un 400 con el nombre del campo, no un 500.

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