Zodiaco chino por año: calculadora de animal y elemento
Introduzca un año de nacimiento para determinar su animal y elemento del zodiaco chino mediante el ciclo tradicional de 60 años.
Ejecutar — gratis
El resultado amplía los doce animales conocidos con el elemento Madera, Fuego, Tierra, Metal o Agua, su polaridad Yin o Yang y el Tronco Celestial y la Rama Terrestre correspondientes. El cálculo emplea aritmética modular fija, por lo que es inmediato, reproducible y adecuado para consultas, contenidos educativos, formularios y aplicaciones que necesitan datos zodiacales estructurados sin depender de un servicio de calendario.
Comprenda qué representa el resultado del año
El zodiaco chino suele presentarse como una secuencia repetida de doce animales, pero la designación completa de un año también incluye uno de cinco elementos y una polaridad Yin o Yang. Esas partes surgen de combinar las doce Ramas Terrestres con los diez Troncos Celestiales. Como ambas secuencias tienen longitudes distintas, una combinación completa solo vuelve a aparecer después de sesenta años. Esta calculadora devuelve el animal, el elemento, la polaridad, el tronco, la rama y la posición dentro de esa secuencia de sesenta años. Por ejemplo, dos personas nacidas con doce años de diferencia suelen compartir animal, aunque pueden tener elementos diferentes porque la secuencia de troncos ha seguido avanzando. La etiqueta reúne las partes más reconocibles, mientras los campos separados facilitan su uso en programas, tablas, filtros y plantillas. Interprete el resultado como una clasificación tradicional del ciclo anual, no como una evaluación científica de personalidad ni una predicción sobre carácter, compatibilidad, salud, suerte o acontecimientos futuros.
Cómo se realiza el cálculo del ciclo de 60 años
El cálculo fija 1984 como la primera posición del ciclo: el año de la Rata de Madera Yang, denominado también Jia-Zi por su Tronco Celestial y Rama Terrestre. Al restar cuatro al año indicado se alinea la numeración gregoriana con los índices iniciales de Rata y Jia. El módulo positivo de doce selecciona el animal y la rama; el de diez determina el tronco, el elemento y la polaridad; y el de sesenta devuelve una posición legible entre uno y sesenta. El módulo positivo mantiene coherente la secuencia incluso para años anteriores a los ejemplos modernos habituales. No intervienen el reloj actual, la configuración regional, solicitudes de red, valores aleatorios ni bases externas de calendarios. Por ello, un mismo entero válido siempre genera el mismo objeto. Se aceptan números enteros y cadenas enteras con formato estricto, incluidos espacios exteriores o un signo explícito, pero se rechazan decimales, notación exponencial, valores ausentes, enteros inseguros y textos que solo comienzan con cifras.
Utilice correctamente la respuesta en aplicaciones reales
Use este resultado cuando un proyecto requiera una clasificación zodiacal convencional basada únicamente en un año gregoriano de nacimiento. Resulta útil para enriquecer perfiles, preparar ejercicios escolares, ambientar eventos, personalizar felicitaciones, crear tablas de consulta y ofrecer funciones culturales sencillas. Recuerde que el año zodiacal tradicional cambia con el Año Nuevo Lunar y no el 1 de enero. Una persona nacida en enero o a comienzos de febrero podría pertenecer al año zodiacal anterior, según la fecha exacta y el límite lunar aplicable. Como esta capacidad recibe únicamente un año, no puede resolver ese caso; solicite la fecha completa y use una herramienta que contemple el calendario lunar cuando sea necesaria una clasificación exacta cerca del año nuevo. Guarde los campos estructurados de animal y elemento en lugar de analizar la etiqueta, pues son más sencillos de traducir y consultar. Cada solicitud API cuesta $0.002. Una entrada no válida provoca un error explícito, sin redondear decimales, extraer cifras de un texto ni sustituir silenciosamente el año actual.
Qué puede hacer con ella
Enriquecer un perfil por año de nacimiento
Añada campos estructurados de animal, elemento, polaridad, tronco y rama cuando solo disponga del año de nacimiento.
Crear una tabla educativa del ciclo
Genere ejemplos coherentes para mostrar cómo doce animales y diez troncos forman una secuencia repetida de 60 años.
Personalizar contenidos temáticos
Seleccione ilustraciones, textos o categorías por año mediante un resultado estable, sin mantener otra tabla de consulta.
Preguntas frecuentes
¿Cuánto cuesta una solicitud?
Cada solicitud API cuesta $0.002.
¿Por qué el resultado incluye un elemento además del animal?
El animal sigue una secuencia de doce ramas, mientras el elemento procede de los diez Troncos Celestiales. Ambos integran el ciclo completo de 60 años.
¿La calculadora tiene en cuenta el Año Nuevo Lunar?
No. Solo asigna un número de año gregoriano. Los nacimientos próximos al Año Nuevo Lunar pueden requerir una fecha exacta y un cálculo adaptado al calendario lunar.
¿Puedo enviar el año como texto?
Sí. Se acepta una cadena formada únicamente por un signo opcional y cifras. Se rechazan decimales, exponentes, cadenas vacías y texto mezclado.
¿Qué significa la posición del ciclo?
Es el lugar numerado del 1 al 60 dentro del ciclo repetido de troncos y ramas, tomando 1984 como posición 1.
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
¿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/misc2/chinese-zodiac-from-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1990}'const res = await fetch("https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"year": 1990
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"year": 1990
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"year":1990}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"year":1990}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/misc2/chinese-zodiac-from-year", 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": 1990
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "misc2.chinese_zodiac_from_year",
"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
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. |