ForHosting KIT · Fechas y tiempo

Elemento del zodiaco chino: animal y Wu Xing del año

2024 es Jia-Chen, el Dragón de Madera yang, año 41 del ciclo de 60 que abrió la Rata de Madera de 1984. Escriba un año y obtendrá su animal, su elemento, si es yin o yang y su posición en el ciclo. Gratis en su navegador.

Gratis
Funciona en su navegador
Sin registro
Sus datos no salen de su equipo

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Ejemplo resuelto

Si escribe

Año: 2 024

Obtiene

Animal del zodiaco: Dragon
Elemento: Wood
Polaridad: yang
Índice de tallo: 0

El zodiaco chino no es solo una lista de doce animales. Cada año lleva también una identidad de los cinco elementos Wu Xing—Madera, Fuego, Tierra, Metal o Agua—tejida en el ciclo sexagenario tradicional de Tallos Celestes y Ramas Terrestres. Ese emparejamiento es lo que la gente quiere decir al hablar de Dragón de Madera, Caballo de Fuego o Rata de Metal: el animal de la secuencia de doce ramas combinado con el elemento y la polaridad yin o yang de la secuencia de diez tallos. Esta calculadora toma un solo año del calendario gregoriano como entero y devuelve el animal, el elemento, la polaridad, las etiquetas pinyin de tallo y rama, el nombre compuesto sexagenario y la posición del uno al sesenta en el ciclo. El mapeo es la fórmula proléptica estándar anclada de modo que mil novecientos ochenta y cuatro sea Jia-Zi, la Rata de Madera Yang que abre un periodo moderno de sesenta años. Los años no enteros se rechazan con un error de validación claro en lugar de un redondeo silencioso.

Cómo funciona el ciclo de 60 años de animal y elemento

Las etiquetas de año chinas en el calendario tradicional combinan dos ciclos independientes. Las Ramas Terrestres recorren doce animales en orden fijo: Rata, Buey, Tigre, Conejo, Dragón, Serpiente, Caballo, Cabra, Mono, Gallo, Perro y Cerdo.

Los Tallos Celestes recorren diez posiciones que codifican tanto el elemento Wu Xing como una polaridad yin o yang: Jia e Yi son Madera, Bing y Ding son Fuego, Wu y Ji son Tierra, Geng y Xin son Metal, Ren y Gui son Agua; los índices de tallo pares son yang y los impares son yin.

El mínimo común múltiplo de doce y diez es sesenta, así que cada par único tallo-rama se repite solo tras sesenta años—el ciclo sexagenario aún usado para datación histórica, horóscopos y nombres culturales de año. El mapeo computacional usado aquí es índice de rama igual a año menos cuatro, módulo doce, e índice de tallo igual a año menos cuatro, módulo diez, con posición de ciclo igual a año menos cuatro módulo sesenta más uno.

Bajo esa convención, mil novecientos ochenta y cuatro es posición de ciclo uno: Jia-Zi, Rata de Madera Yang. Dos mil veinticuatro es Jia-Chen, Dragón de Madera Yang; dos mil veinte es Geng-Zi, Rata de Metal Yang. El algoritmo es aritmética modular pura sobre un año entero: sin reloj de pared, sin semilla aleatoria, sin llamada de red y sin deriva de punto flotante.

Los años negativos siguen bien definidos porque la implementación usa módulo positivo, de modo que el ciclo proléptico continúa hacia atrás para investigación histórica sin lanzar error. Lo que esta herramienta solo de año deliberadamente no hace es desplazar el límite en el Año Nuevo chino; si necesita el corte lunar exacto para una fecha de nacimiento en enero o principios de febrero, aún necesita un conversor de calendario lunisolar, que es una intención de búsqueda y una página distintas.

Dónde aparecen las consultas de elemento del zodiaco chino en el trabajo real

Los equipos editoriales y de marketing planifican campañas de Año Nuevo lunar con meses de antelación y necesitan textos fiables de animal más elemento para cada año de mercado sin mantener a mano una hoja de cálculo que se desvía tras cada década. Educadores que enseñan historia de Asia Oriental o estudios culturales asignan ejercicios de datación sexagenaria y quieren un único oráculo que devuelva tanto el nombre popular del animal como el compuesto formal tallo-rama para que los estudiantes contrasten libros de texto.

Las herramientas de genealogía e historia familiar almacenan años de nacimiento de fuentes mixtas occidentales y chinas y se benefician de un mapa determinista año-a-etiqueta al construir líneas de tiempo o validar documentos transcritos. Diseñadores de juegos, novelistas y desarrolladores de apps que construyen trasfondos de personajes o temas de eventos anuales a menudo necesitan el matiz de los cinco elementos de un año—Caballo de Fuego frente a Caballo de Agua—no solo el glifo del animal.

Si más adelante necesita cartas Ba Zi de cuatro pilares a partir de una fecha-hora de nacimiento precisa, astrología occidental de signos solares u ordinales de día del año dentro de un año gregoriano, trátelos como intenciones de búsqueda y páginas distintas en lugar de sobrecargar esta calculadora de elemento del zodiaco chino basada en el año.

Qué puede hacer con ella

Textos de campaña de Año Nuevo lunar

Genere el nombre correcto de animal y año de cinco elementos para páginas de producto, correos y publicaciones sociales antes de cada campaña de Año Nuevo chino.

Ejercicios sexagenarios en el aula

Dé a los estudiantes el animal, el pinyin tallo-rama y la posición del ciclo de cualquier año para que las claves de deberes coincidan con un único oráculo determinista.

Etiquetas de genealogía y líneas de tiempo

Anote años de nacimiento y eventos con nombres de año chinos tradicionales (elemento + animal) al construir historias familiares o líneas de tiempo históricas.

Preguntas frecuentes

¿Cómo se calcula el animal del zodiaco chino a partir de un año?

El índice de Rama Terrestre es (año − 4) módulo 12, mapeando 0–11 de Rata a Cerdo. Por ejemplo, 2024 da índice de rama 4, que es Dragón.

¿Cómo se determina el emparejamiento de los cinco elementos?

El índice de Tallo Celeste es (año − 4) módulo 10. Los tallos se mapean por pares a Madera, Fuego, Tierra, Metal y Agua; los índices pares son yang y los impares son yin.

¿Qué es el ciclo sexagenario de 60 años?

Es el mínimo común múltiplo de los 12 animales y 10 tallos. Cada par único tallo-rama (por ejemplo Jia-Chen) se repite cada 60 años. La posición 1 en esta herramienta es 1984, Jia-Zi Rata de Madera.

¿Tiene en cuenta el Año Nuevo chino?

No. La entrada es solo un año nominal del calendario gregoriano. Quienes nacen en enero o principios de febrero pueden pertenecer al año lunar chino anterior; use un conversor lunisolar para ese límite.

¿Cuánto cuesta?

La herramienta del navegador es gratuita y se ejecuta en local.

Herramientas relacionadas

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/date/chinese-zodiac-element

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/date/chinese-zodiac-element \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024}'

const res = await fetch("https://api.kit.forhosting.com/date/chinese-zodiac-element", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2024
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/chinese-zodiac-element",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2024
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/chinese-zodiac-element", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2024}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2024}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/chinese-zodiac-element", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "year": 2024
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.chinese_zodiac_element",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Notas técnicas

Qué envía y qué recibe de vuelta

Envíe un campo obligatorio llamado year como año entero del calendario gregoriano, por ejemplo dos mil veinticuatro. En caso de éxito la respuesta repite el year y devuelve animal como uno de los doce nombres de animal en inglés, element como uno de Wood, Fire, Earth, Metal o Water, y polarity como yin o yang. Comprobaciones clásicas de sanidad incluyen mil novecientos ochenta y cuatro como Yang Wood Rat en posición de ciclo uno, dos mil como Yang Metal Dragon, dos mil doce como Yang Water Dragon, y dos mil veinticinco como Yin Wood Ox. Se aceptan cadenas de dígitos enteros cuando se interpretan limpiamente como números enteros; números fraccionarios, cadenas vacías, valores booleanos y texto no numérico fallan con invalid_input y no se cobran. También devuelve stem_index y branch_index basados en cero para uso programático, stem_pinyin y branch_pinyin para etiquetas tradicionales como Jia y Chen, sexagenary como el nombre tallo-rama con guion, cycle_position del uno al sesenta, cycle_length siempre sesenta, una etiqueta legible como Yang Wood Dragon, y una cadena formula corta que documenta las reglas modulares para que los revisores auditen el mapeo sin leer el código fuente. El precio de las llamadas API correctas es la base publicada de $0.002 por ítem; los fallos de validación no consumen saldo prepago.

Ver la documentación completa del KIT →

Ejecutar — gratis