Zodíaco chinês pelo ano: animal e elemento
Informe um ano de nascimento para descobrir o animal e o elemento do zodíaco chinês no ciclo tradicional de 60 anos.
Executar grátis
O resultado vai além dos doze animais conhecidos e apresenta o elemento Madeira, Fogo, Terra, Metal ou Água, a polaridade Yin ou Yang e o Tronco Celestial e Ramo Terrestre correspondentes. O cálculo usa aritmética modular fixa, portanto é imediato, repetível e apropriado para consultas, materiais educativos, formulários e aplicativos que precisam de dados zodiacais estruturados sem depender de um serviço de calendário.
Entenda o significado do resultado anual
O zodíaco chinês costuma ser apresentado como uma sequência recorrente de doze animais, mas a designação completa de um ano também contém um dos cinco elementos e uma polaridade Yin ou Yang. Essas partes resultam da combinação dos doze Ramos Terrestres com os dez Troncos Celestiais. Como as sequências possuem extensões diferentes, a mesma combinação completa reaparece somente depois de sessenta anos. Esta calculadora informa o animal, o elemento, a polaridade, o nome do tronco, o nome do ramo e a posição do ano nessa sequência. Duas pessoas nascidas com doze anos de diferença geralmente compartilham o animal, mas podem ter elementos distintos porque a sequência dos troncos continuou avançando. O rótulo reúne os componentes mais conhecidos em uma frase curta, enquanto os campos separados são convenientes para sistemas, tabelas, filtros e modelos de exibição. Considere o resultado uma classificação tradicional do ciclo anual, e não uma avaliação científica de personalidade ou uma previsão de caráter, compatibilidade, saúde, sorte ou acontecimentos futuros.
Como funciona o cálculo do ciclo de 60 anos
O cálculo adota 1984 como a primeira posição do ciclo: o ano do Rato de Madeira Yang, também chamado Jia-Zi conforme seu Tronco Celestial e Ramo Terrestre. Subtrair quatro do ano informado alinha a numeração gregoriana aos índices iniciais de Rato e Jia. O módulo positivo por doze escolhe o animal e o ramo; por dez escolhe o tronco, o elemento e a polaridade; e por sessenta produz uma posição legível de um a sessenta. O módulo positivo mantém a sequência coerente mesmo para anos anteriores aos exemplos modernos mais comuns. O relógio atual, a localidade, a rede, valores aleatórios e bancos externos de calendário não participam da resposta. Assim, o mesmo inteiro válido sempre gera o mesmo objeto. A ferramenta aceita números inteiros e textos inteiros em formato rigoroso, inclusive com espaços externos ou sinal explícito, mas recusa decimais, notação exponencial, valores ausentes, inteiros inseguros e textos que apenas começam com algarismos.
Use a resposta corretamente em aplicações reais
Use o resultado quando um projeto precisar de uma classificação zodiacal convencional baseada apenas no ano gregoriano de nascimento. Ele atende bem ao enriquecimento de perfis, exercícios escolares, temas de eventos, personalização de cartões, tabelas de referência e recursos leves de interesse cultural. Lembre-se de que o ano zodiacal tradicional muda no Ano-Novo Lunar, e não em 1º de janeiro. Uma pessoa nascida em janeiro ou no começo de fevereiro pode pertencer ao ano zodiacal anterior, dependendo da data exata e do limite lunar aplicável. Como esta capacidade recebe somente o ano, ela não resolve esse caso; solicite a data completa e use uma ferramenta compatível com o calendário lunar quando a classificação precisa perto do ano-novo for importante. Armazene os campos estruturados de animal e elemento em vez de interpretar o rótulo, pois campos separados são mais fáceis de traduzir e consultar. Cada solicitação de API custa US$ 0,002. Entradas inválidas geram um erro explícito, sem arredondar decimais, extrair números de frases nem substituir silenciosamente pelo ano atual.
Casos de uso
Enriquecer um perfil pelo ano de nascimento
Inclua campos estruturados de animal, elemento, polaridade, tronco e ramo quando somente o ano de nascimento estiver disponível.
Montar uma tabela educativa do ciclo
Produza exemplos consistentes que mostram como doze animais e dez troncos formam uma sequência recorrente de 60 anos.
Personalizar conteúdo temático
Escolha imagens, textos ou categorias vinculados ao ano usando um resultado estável, sem manter outra tabela de consulta.
Perguntas frequentes
Quanto custa uma solicitação?
Cada solicitação de API custa US$ 0,002.
Por que o resultado traz um elemento além do animal?
O animal segue uma sequência de doze ramos, enquanto o elemento deriva dos dez Troncos Celestiais. Juntos, eles integram o ciclo completo de 60 anos.
A calculadora considera o Ano-Novo Lunar?
Não. Ela associa somente o número do ano gregoriano. Nascimentos perto do Ano-Novo Lunar podem exigir a data exata e um cálculo compatível com o calendário lunar.
Posso enviar o ano como texto?
Sim. Aceita-se uma sequência contendo apenas sinal opcional e algarismos. Decimais, expoentes, conteúdo vazio ou texto misto são recusados.
O que significa a posição no ciclo?
É o lugar numerado de 1 a 60 no ciclo recorrente de troncos e ramos, tendo 1984 como posição 1.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"year": 1990
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "misc2.chinese_zodiac_from_year",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |