ForHosting KIT · Datas e tempo

Elemento do zodíaco chinês: animal e Wu Xing do ano

2024 é Jia-Chen, o Dragão de Madeira yang, ano 41 do ciclo de 60 que começou com o Rato de Madeira de 1984. Digite um ano e receba o animal, o elemento, se é yin ou yang e a posição no ciclo. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Ano: 2.024

Você obtém

Animal do zodíaco: Dragon
Elemento: Wood
Polaridade: yang
Índice do tronco: 0

O zodíaco chinês não é só uma lista de doze animais. Cada ano também carrega uma identidade dos cinco elementos Wu Xing—Madeira, Fogo, Terra, Metal ou Água—tecida no ciclo sexagenário tradicional de Troncos Celestes e Ramos Terrestres. Esse emparelhamento é o que as pessoas querem dizer ao falar em Dragão de Madeira, Cavalo de Fogo ou Rato de Metal: o animal da sequência de doze ramos combinado com o elemento e a polaridade yin ou yang da sequência de dez troncos. Esta calculadora recebe um único ano do calendário gregoriano como inteiro e devolve o animal, o elemento, a polaridade, os rótulos pinyin de tronco e ramo, o nome composto sexagenário e a posição de um a sessenta no ciclo. O mapeamento é a fórmula proléptica padrão ancorada de modo que mil novecentos e oitenta e quatro seja Jia-Zi, o Rato de Madeira Yang que abre um período moderno de sessenta anos. Anos não inteiros são rejeitados com um erro de validação claro em vez de arredondamento silencioso.

Como funciona o ciclo de 60 anos de animal e elemento

Os rótulos de ano chineses no calendário tradicional combinam dois ciclos independentes. Os Ramos Terrestres percorrem doze animais em ordem fixa: Rato, Boi, Tigre, Coelho, Dragão, Serpente, Cavalo, Cabra, Macaco, Galo, Cão e Porco. Os Troncos Celestes percorrem dez posições que codificam tanto o elemento Wu Xing quanto uma polaridade yin ou yang: Jia e Yi são Madeira, Bing e Ding são Fogo, Wu e Ji são Terra, Geng e Xin são Metal, Ren e Gui são Água; índices de tronco pares são yang e ímpares são yin.

O mínimo múltiplo comum de doze e dez é sessenta, então cada par único tronco-ramo se repete só após sessenta anos—o ciclo sexagenário ainda usado para datação histórica, horóscopos e nomes culturais de ano. O mapeamento computacional usado aqui é índice de ramo igual a ano menos quatro, módulo doze, e índice de tronco igual a ano menos quatro, módulo dez, com posição de ciclo igual a ano menos quatro módulo sessenta mais um.

Sob essa convenção, mil novecentos e oitenta e quatro é posição de ciclo um: Jia-Zi, Rato de Madeira Yang. Dois mil e vinte e quatro é Jia-Chen, Dragão de Madeira Yang; dois mil e vinte é Geng-Zi, Rato de Metal Yang. O algoritmo é aritmética modular pura sobre um ano inteiro: sem relógio de parede, sem semente aleatória, sem chamada de rede e sem deriva de ponto flutuante.

Anos negativos permanecem bem definidos porque a implementação usa módulo positivo, assim o ciclo proléptico continua para trás para pesquisa histórica sem lançar erro. O que esta ferramenta só de ano deliberadamente não faz é deslocar o limite no Ano Novo chinês; se você precisar do corte lunar exato para uma data de nascimento em janeiro ou início de fevereiro, ainda precisa de um conversor de calendário lunissolar, que é uma intenção de busca e uma página diferentes.

Onde consultas de elemento do zodíaco chinês aparecem no trabalho real

Equipes editoriais e de marketing planejam campanhas de Ano Novo lunar com meses de antecedência e precisam de textos confiáveis de animal mais elemento para cada ano de mercado sem manter à mão uma planilha que se desvia após cada década. Educadores que ensinam história do Leste Asiático ou estudos culturais atribuem exercícios de datação sexagenária e querem um único oráculo que devolva tanto o nome popular do animal quanto o composto formal tronco-ramo para que os alunos confrontem livros didáticos.

Ferramentas de genealogia e história familiar armazenam anos de nascimento de fontes mistas ocidentais e chinesas e se beneficiam de um mapa determinístico ano-para-rótulo ao construir linhas do tempo ou validar documentos transcritos. Designers de jogos, romancistas e desenvolvedores de apps que constroem históricos de personagens ou temas de eventos anuais frequentemente precisam do matiz dos cinco elementos de um ano—Cavalo de Fogo versus Cavalo de Água—não só o glifo do animal.

Se mais tarde você precisar de cartas Ba Zi de quatro pilares a partir de data-hora de nascimento precisa, astrologia ocidental de signos solares ou ordinais de dia do ano dentro de um ano gregoriano, trate-os como intenções de busca e páginas separadas em vez de sobrecarregar esta calculadora de elemento do zodíaco chinês baseada no ano.

Casos de uso

Textos de campanha de Ano Novo lunar

Gere o nome correto de animal e ano dos cinco elementos para páginas de produto, e-mails e posts sociais antes de cada campanha de Ano Novo chinês.

Exercícios sexagenários em sala de aula

Dê aos alunos o animal, o pinyin tronco-ramo e a posição do ciclo de qualquer ano para que as chaves de lição de casa coincidam com um único oráculo determinístico.

Rótulos de genealogia e linhas do tempo

Anote anos de nascimento e eventos com nomes de ano chineses tradicionais (elemento + animal) ao construir histórias familiares ou linhas do tempo históricas.

Perguntas frequentes

Como o animal do zodíaco chinês é calculado a partir de um ano?

O índice do Ramo Terrestre é (ano − 4) módulo 12, mapeando 0–11 de Rato a Porco. Por exemplo, 2024 dá índice de ramo 4, que é Dragão.

Como se determina o emparelhamento dos cinco elementos?

O índice do Tronco Celeste é (ano − 4) módulo 10. Os troncos mapeiam em pares para Madeira, Fogo, Terra, Metal e Água; índices pares são yang e ímpares são yin.

O que é o ciclo sexagenário de 60 anos?

É o mínimo múltiplo comum dos 12 animais e 10 troncos. Cada par único tronco-ramo (por exemplo Jia-Chen) se repete a cada 60 anos. A posição 1 nesta ferramenta é 1984, Jia-Zi Rato de Madeira.

Isso leva em conta o Ano Novo chinês?

Não. A entrada é apenas um ano nominal do calendário gregoriano. Quem nasce em janeiro ou início de fevereiro pode pertencer ao ano lunar chinês anterior; use um conversor lunissolar para esse limite.

Quanto custa?

A ferramenta do navegador é gratuita e roda localmente.

Ferramentas relacionadas

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

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

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/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)

Exemplo de requisição

{
  "year": 2024
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.chinese_zodiac_element",
  "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

por chamadaUS$ 0,002

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.

Notas técnicas

O que você envia e o que recebe de volta

Envie um campo obrigatório chamado year como ano inteiro do calendário gregoriano, por exemplo dois mil e vinte e quatro. Em caso de sucesso a resposta ecoa o year e devolve animal como um dos doze nomes de animal em inglês, element como um de Wood, Fire, Earth, Metal ou Water, e polarity como yin ou yang. Checagens clássicas de sanidade incluem mil novecentos e oitenta e quatro como Yang Wood Rat na posição de ciclo um, dois mil como Yang Metal Dragon, dois mil e doze como Yang Water Dragon, e dois mil e vinte e cinco como Yin Wood Ox. Cadeias de dígitos inteiros são aceitas quando se interpretam limpidamente como números inteiros; números fracionários, cadeias vazias, valores booleanos e texto não numérico falham com invalid_input e não são cobrados. Também devolve stem_index e branch_index baseados em zero para uso programático, stem_pinyin e branch_pinyin para rótulos tradicionais como Jia e Chen, sexagenary como o nome tronco-ramo hifenizado, cycle_position de um a sessenta, cycle_length sempre sessenta, um rótulo legível como Yang Wood Dragon, e uma string formula curta que documenta as regras modulares para que revisores auditem o mapeamento sem ler o código-fonte. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.

Ver a documentação completa do KIT →

Executar grátis