ForHosting KIT · Dates et temps

Élément du zodiaque chinois : animal et Wu Xing de l’année

2024 est Jia-Chen, le Dragon de Bois yang, année 41 du cycle de 60 ans ouvert par le Rat de Bois de 1984. Saisissez une année pour obtenir son animal, son élément, son yin ou son yang et sa position dans le cycle. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Année: 2 024

Vous obtenez

Animal du zodiaque: Dragon
Élément: Wood
Polarité: yang
Indice de tronc: 0

Le zodiaque chinois n’est pas seulement une liste de douze animaux. Chaque année porte aussi une identité des cinq éléments Wu Xing—Bois, Feu, Terre, Métal ou Eau—tissée dans le cycle sexagésimal traditionnel des Troncs Célestes et des Branches Terrestres. Ce couplage est ce que les gens entendent par Dragon de Bois, Cheval de Feu ou Rat de Métal : l’animal de la séquence des douze branches combiné à l’élément et à la polarité yin ou yang de la séquence des dix troncs. Ce calculateur prend une seule année du calendrier grégorien comme entier et renvoie l’animal, l’élément, la polarité, les libellés pinyin de tronc et de branche, le nom composé sexagésimal et la position de un à soixante dans le cycle. Le mapping est la formule proloptique standard ancrée de sorte que mil neuf cent quatre-vingt-quatre soit Jia-Zi, le Rat de Bois Yang qui ouvre une période moderne de soixante ans. Les années non entières sont rejetées avec une erreur de validation claire au lieu d’un arrondi silencieux.

Comment fonctionne le cycle de 60 ans animal et élément

Les libellés d’année chinois dans le calendrier traditionnel combinent deux cycles indépendants. Les Branches Terrestres parcourent douze animaux dans un ordre fixe : Rat, Bœuf, Tigre, Lapin, Dragon, Serpent, Cheval, Chèvre, Singe, Coq, Chien et Cochon.

Les Troncs Célestes parcourent dix positions qui encodent à la fois l’élément Wu Xing et une polarité yin ou yang : Jia et Yi sont Bois, Bing et Ding sont Feu, Wu et Ji sont Terre, Geng et Xin sont Métal, Ren et Gui sont Eau ; les indices de tronc pairs sont yang et les impairs sont yin.

Le plus petit commun multiple de douze et dix est soixante, donc chaque paire unique tronc-branche ne se répète qu’après soixante ans—le cycle sexagésimal encore utilisé pour la datation historique, les horoscopes et les noms culturels d’année. Le mapping computationnel utilisé ici est l’indice de branche égal à l’année moins quatre, modulo douze, et l’indice de tronc égal à l’année moins quatre, modulo dix, avec la position de cycle égale à l’année moins quatre modulo soixante plus un.

Sous cette convention, mil neuf cent quatre-vingt-quatre est la position de cycle un : Jia-Zi, Rat de Bois Yang. Deux mille vingt-quatre est Jia-Chen, Dragon de Bois Yang ; deux mille vingt est Geng-Zi, Rat de Métal Yang. L’algorithme est une arithmétique modulaire pure sur une année entière : pas d’horloge murale, pas de graine aléatoire, pas d’appel réseau et pas de dérive en virgule flottante.

Les années négatives restent bien définies car l’implémentation utilise un modulo positif, ainsi le cycle proloptique continue vers l’arrière pour la recherche historique sans lever d’erreur. Ce que cet outil année seule ne fait délibérément pas, c’est décaler la frontière au Nouvel An chinois ; si vous avez besoin de la coupure lunaire exacte pour une date de naissance en janvier ou début février, vous avez encore besoin d’un convertisseur de calendrier lunisolaire, qui est une intention de recherche et une page différentes.

Où les recherches d’élément du zodiaque chinois apparaissent dans le travail réel

Les équipes éditoriales et marketing planifient les campagnes de Nouvel An lunaire des mois à l’avance et ont besoin de textes fiables animal-plus-élément pour chaque année de marché sans maintenir à la main une feuille de calcul qui dérive après chaque décennie. Les enseignants d’histoire de l’Asie de l’Est ou d’études culturelles assignent des exercices de datation sexagésimale et veulent un oracle unique qui renvoie à la fois le nom populaire de l’animal et le composé formel tronc-branche pour que les élèves confrontent les manuels.

Les outils de généalogie et d’histoire familiale stockent des années de naissance de sources mixtes occidentales et chinoises et bénéficient d’une carte déterministe année-vers-libellé en construisant des frises chronologiques ou en validant des documents transcrits. Concepteurs de jeux, romanciers et développeurs d’apps construisant des arrière-plans de personnages ou des thèmes d’événements annuels ont souvent besoin de la saveur des cinq éléments d’une année—Cheval de Feu versus Cheval d’Eau—pas seulement le glyphe de l’animal.

Si vous avez ensuite besoin de cartes Ba Zi à quatre piliers à partir d’une date-heure de naissance précise, d’astrologie occidentale de signes solaires ou d’ordinaux de jour de l’année dans une année grégorienne, traitez-les comme des intentions de recherche et des pages séparées plutôt que de surcharger ce calculateur d’élément du zodiaque chinois basé sur l’année.

Cas d’usage

Textes de campagne de Nouvel An lunaire

Générez le nom correct d’animal et d’année à cinq éléments pour pages produit, e-mails et publications sociales avant chaque campagne de Nouvel An chinois.

Exercices sexagésimaux en classe

Donnez aux élèves l’animal, le pinyin tronc-branche et la position de cycle de n’importe quelle année pour que les corrigés de devoirs correspondent à un oracle déterministe unique.

Libellés de généalogie et frises chronologiques

Annotez les années de naissance et d’événements avec des noms d’année chinois traditionnels (élément + animal) en construisant des histoires familiales ou des frises historiques.

Questions fréquentes

Comment l’animal du zodiaque chinois est-il calculé à partir d’une année ?

L’indice de Branche Terrestre est (année − 4) modulo 12, mappant 0–11 de Rat à Cochon. Par exemple, 2024 donne l’indice de branche 4, qui est Dragon.

Comment le couplage des cinq éléments est-il déterminé ?

L’indice de Tronc Céleste est (année − 4) modulo 10. Les troncs se mappent par paires à Bois, Feu, Terre, Métal et Eau ; les indices pairs sont yang et les impairs sont yin.

Qu’est-ce que le cycle sexagésimal de 60 ans ?

C’est le plus petit commun multiple des 12 animaux et 10 troncs. Chaque paire unique tronc-branche (par exemple Jia-Chen) se répète tous les 60 ans. La position 1 dans cet outil est 1984, Jia-Zi Rat de Bois.

Cela tient-il compte du Nouvel An chinois ?

Non. L’entrée est uniquement une année nominale du calendrier grégorien. Les personnes nées en janvier ou début février peuvent appartenir à l’année lunaire chinoise précédente ; utilisez un convertisseur lunisolaire pour cette frontière.

Quel est le coût ?

L’outil du navigateur est gratuit et s’exécute en local.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

{
  "year": 2024
}

Exemple de réponse

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

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Ce que vous envoyez et ce que vous recevez

Envoyez un champ obligatoire nommé year comme année entière du calendrier grégorien, par exemple deux mille vingt-quatre. En cas de succès la réponse renvoie le year et retourne animal comme l’un des douze noms d’animaux en anglais, element comme l’un de Wood, Fire, Earth, Metal ou Water, et polarity comme yin ou yang. Les contrôles de cohérence classiques incluent mil neuf cent quatre-vingt-quatre comme Yang Wood Rat en position de cycle un, deux mille comme Yang Metal Dragon, deux mille douze comme Yang Water Dragon, et deux mille vingt-cinq comme Yin Wood Ox. Les chaînes de chiffres entiers sont acceptées lorsqu’elles s’analysent proprement en nombres entiers ; les nombres fractionnaires, chaînes vides, valeurs booléennes et texte non numérique échouent avec invalid_input et ne sont pas facturés. Elle renvoie aussi stem_index et branch_index basés sur zéro pour un usage programmatique, stem_pinyin et branch_pinyin pour des libellés traditionnels tels que Jia et Chen, sexagenary comme le nom tronc-branche avec trait d’union, cycle_position de un à soixante, cycle_length toujours soixante, un libellé lisible tel que Yang Wood Dragon, et une courte chaîne formula qui documente les règles modulaires pour que les relecteurs audient le mapping sans lire le code source. Le tarif des appels API réussis est la base publiée de $0.002 par item ; les échecs de validation ne consomment pas le solde prépayé.

Consulter la documentation complète du KIT →

Lancer gratuitement