Tong Shu (elección de fecha)

Tong Shu (通書) es el almanaque chino con el que tradicionalmente se elige el día. Dos de sus capas se calculan con exactitud, y son precisamente las que están implementadas aquí: los doce oficiales del día (建除十二神) y las veintiocho mansiones (二十八宿).

Endpoints

Endpoint	Créditos	Qué devuelve
POST /v1/chinese/tong-shu	10	Un día: pilar del día, oficial, mansión, animal en choque
POST /v1/chinese/tong-shu/select	20	Los días de un rango que el registro aprueba para una actividad

Los doce oficiales del día

La regla es una sola. El día cuya rama terrestre coincide con la rama del mes es 建 Establish, y a partir de ahí los doce se suceden en círculo. El mes se determina aquí por el momento exacto del término solar, no por el día uno, así que el oficial puede cambiar a mitad del mes de calendario.

#	中文	Nombre	De qué va el día
1	建	Establish	Comienzo, pero no culminación
2	除	Remove	Limpiar, deshacerse de algo
3	滿	Full	Plenitud, firma, inauguración
4	平	Balance	Llano, cotidiano, seguro
5	定	Stable	Lo que debe perdurar
6	執	Control	Tomar las riendas
7	破	Destruction	Día que choca con el mes
8	危	Danger	Altura y riesgo
9	成	Success	El más favorable de los doce
10	收	Collect	Reunir, recibir
11	開	Open	Abrir, dejar entrar
12	閉	Close	Sellar; el más bajo de todos

Las veintiocho mansiones

La mansión cambia cada día en un ciclo continuo de 28 días, y ese ciclo está anclado a la semana: 角 siempre cae en jueves, porque 28 son exactamente cuatro semanas. Esta propiedad no es decorativa, es la propia comprobación: un ancla equivocada desplazaría la secuencia respecto al almanaque publicado o rompería el día de la semana.

Ejemplo

Un día

curl -X POST https://api.astroway.info/v1/chinese/tong-shu \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-09-12" }'

Elección de fecha

curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-09-01", "to": "2026-12-31",
        "activity": "marriage", "avoidClashWith": "Rat" }'

Actividades: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Nota

Tres veredictos, y neutral no significa “da igual”. suitable y unsuitable son lo que el registro dice explícitamente. neutral significa que la tradición guarda silencio sobre esa actividad. Por eso los días silenciosos no entran en la selección por defecto, y se pueden pedir con includeNeutral.

Precaución

El rango está limitado a 366 días, y uno más largo se rechaza, no se recorta. Una respuesta recortada en silencio se leería como “después de marzo no hay días buenos”, cuando en realidad nadie ha mirado ahí. La respuesta siempre incluye scanned, matched y dropped con el desglose, así que la suma cuadra.

Qué está comprobado

• Los oficiales se han cotejado con un ejemplo resuelto publicado: diciembre de 2020 en el mes de la Rata, donde el 11 de diciembre es el primer Establish, y el 8, 9 y 10 de diciembre son Collect, Open y Close. Los cuatro coinciden.
• Las mansiones se han cotejado con la secuencia diaria de un almanaque japonés de agosto de 2026: veinte días seguidos, de 女 el uno de agosto a 角 el día veinte. Además del invariante del día de la semana, comprobado sobre un siglo de fechas.
• El pilar del día queda ahora fijado por tres fechas publicadas (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Antes solo se mencionaban en un comentario y nada las comprobaba.

La selección se hace por oficiales, no por mansiones. La mansión se devuelve para cada día, pero no filtra: su registro de actividades varía entre almanaques y no nos lo inventamos. Por la misma razón no están implementadas las tablas de 神煞: son decenas de series que se solapan, sin acuerdo entre las fuentes.