ForHosting KIT · Dates et temps

Calculateur de zodiaque chinois

2024 est l'année du Dragon, mais une personne née le 9 février 2024 reste Lapin, car l'animal change au Nouvel An chinois et non le 1er janvier. Saisissez une année ou une date complète pour obtenir le bon signe. 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: Dragon
Index de l'animal: 4
Position dans le cycle: 5
Année zodiacale: 2 024

Ce calculateur de zodiaque chinois prend une année du calendrier grégorien et renvoie le signe traditionnel à douze animaux associé à cette année dans le cycle luni-solaire chinois : Rat, Buffle, Tigre, Lapin, Dragon, Serpent, Cheval, Chèvre, Singe, Coq, Chien, ou Cochon. Lorsque vous ne fournissez qu'une année, la correspondance suit l'étiquette civile standard utilisée quand on dit « 2024 est l'année du Dragon », via la formule fermée index égal année moins quatre, modulo douze. Quand les choses se compliquent près de fin janvier ou début février, vous pouvez aussi passer un mois et un jour afin que le moteur applique la coupure du Nouvel An chinois : les dates antérieures au Nouvel An lunaire de cette année appartiennent à l'animal précédent. Parmi les vérifications simples que vous connaissez peut-être déjà : l'année 2020 est Rat, l'année 2024 est Dragon, et le 9 février 2024 est Lapin tandis que le 10 février 2024 est Dragon. Le moteur n'utilise qu'une arithmétique finie et un parcours luni-solaire pur basé sur les nouvelles lunes, sans appel réseau, sans échantillonnage, sans objets Date d'horloge hôte.

Ce que signifie l'animal du zodiaque chinois et ce que contient la réponse

Le zodiaque chinois est un cycle de douze ans d'animaux qui étiquette chaque année dans le calendrier luni-solaire traditionnel d'Asie de l'Est. Dans le langage courant, les gens associent un animal à une année civile grégorienne — 2025 est l'année du Serpent — tandis qu'un travail culturel et généalogique rigoureux respecte aussi le fait que l'animal change réellement au Nouvel An chinois, qui tombe entre fin janvier et mi-février, et non le premier janvier.

Ce calculateur accepte une année entière obligatoire de un à neuf mille neuf cent quatre-vingt-dix-neuf et des champs facultatifs de mois et de jour grégoriens. Les signes solaires occidentaux, les branches terrestres horaires chinoises, et les tableaux de tiges-branches à cinq éléments sont intentionnellement hors périmètre. Si vous avez besoin des dates de Pâques, des numéros de semaine ISO, ou d'arithmétique de date générique, utilisez ces outils dédiés ; cette page ne répond qu'à l'animal du zodiaque chinois pour une année validée et une date de coupure facultative.

Où les recherches du zodiaque chinois s'inscrivent dans la culture, le produit et le logiciel

Rédacteurs et spécialistes marketing écrivant des textes saisonniers ont besoin d'une correspondance stable entre année et animal afin que titres et noms d'actifs restent cohérents d'une campagne à l'autre. Les produits de généalogie et d'éducation culturelle veulent le parcours de date facultatif afin qu'un anniversaire proche du Nouvel An chinois n'hérite pas silencieusement du mauvais signe.

Les développeurs appellent le même contrat depuis des scripts pour amorcer des tableaux de localisation, pour générer des vecteurs de test déterministes pour des badges de profil, ou pour satisfaire des exigences produit demandant une formule documentée plutôt qu'une liste codée en dur qui devient obsolète. Les enseignants utilisent l'outil pour montrer comment un cycle modulaire de douze ans et un Nouvel An lunaire mobile interagissent, et pour démontrer des dates limites en janvier et février sans faire confiance à des applications de calcul opaques qui se contredisent entre elles.

Les organisateurs d'événements et les équipes d'hôtellerie construisant des promotions du Nouvel An lunaire peuvent confirmer quel animal s'applique à un jour civil précis avant d'imprimer des supports. Associez-le à d'autres auxiliaires de date déterministes gratuits pour bâtir un petit laboratoire d'utilitaires calendaires pour l'enseignement, la conformité ou les fonctionnalités produit.

Cas d’usage

Étiquettes année-de-l'animal

Associez toute année civile au Rat jusqu'au Cochon pour des articles, des noms de campagne et des badges d'interface à l'aide du cycle modulaire standard.

Anniversaires proches du Nouvel An lunaire

Passez mois et jour afin que les dates antérieures au Nouvel An chinois se résolvent en l'animal précédent plutôt qu'en l'étiquette de l'année civile.

Questions fréquentes

Combien coûte le calculateur de zodiaque chinois ?

Il est gratuit dans votre navigateur sur cette page.

Comment l'animal est-il choisi à partir d'une seule année ?

Par exemple, 2020 est Rat et 2024 est Dragon.

Que se passe-t-il si j'envoie aussi mois et jour ?

Le moteur calcule le Nouvel An chinois pour cette année. Les dates strictement antérieures au Nouvel An utilisent l'année zodiacale précédente ; le jour du Nouvel An et après conservent l'animal de l'année civile.

Que se passe-t-il si l'année n'est pas un entier ?

L'année doit être un entier de 1 à 9999.

Cet outil renvoie-t-il des signes astrologiques occidentaux ?

Non. Il ne renvoie que le zodiaque chinois à douze animaux pour une année (et une date de coupure du Nouvel An lunaire facultative).

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

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 \
  -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", {
  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",
    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", 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", 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",
  "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.

Limites

`year_min`	1
`year_max`	9999

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 signifie l'animal du zodiaque chinois et ce que contient la réponse

Il renvoie l'année normalisée, le nom de l'animal, un animal_index de base zéro dans l'ordre fixe Rat à Cochon, une cycle_position de base un, la zodiac_year résolue (qui peut être année moins un lorsque la date précède le Nouvel An chinois), un indicateur before_new_year, l'étiquette de méthode chinese_zodiac, et un court rappel de formule. Lorsqu'une date est fournie, la réponse reprend aussi month, day, une chaîne date au format AAAA-MM-JJ, et les champs chinese_new_year calculés pour cette année civile. Il n'y a aucun téléchargement d'éphéméride distante et aucun échantillonnage folklorique aléatoire : soit les entrées se valident et l'animal est entièrement déterminé, soit la requête échoue avec invalid_input. Les cas rejetés incluent une année manquante, des jetons d'année non entiers, des années hors de la plage documentée, un mois sans jour ou l'inverse, et des jours calendaires impossibles tels que le 31 avril.

Comment year, month et day sont lus et comment la coupure reste reproductible

Les chaînes numériques avec signes plus ou moins initiaux facultatifs sont acceptées lorsqu'elles s'analysent comme des entiers ; les points décimaux, la notation scientifique, les préfixes hexadécimaux et les chaînes vides sont rejetés avec un message clair afin qu'une cellule erronée ne devienne pas le mauvais animal. Après analyse, l'année doit être comprise entre un et neuf mille neuf cent quatre-vingt-dix-neuf inclus pour correspondre aux autres auxiliaires calendaires du catalogue. Lorsque month et day sont présents, le moteur calcule le Nouvel An chinois pour cette année civile à l'aide d'une arithmétique pure de jour julien et de nouvelle lune dans le fuseau horaire standard chinois de huit heures est par rapport à UTC, sans jamais appeler l'objet Date de JavaScript. Le champ privilégié est year, mais les alias y, Y majuscule et yr sont acceptés afin que tableurs, chaînes de requête et formulaires typés puissent réutiliser le même contrat sans renommer de colonnes. Les champs facultatifs month et day doivent arriver ensemble : alias m, M majuscule et mon pour le mois, et d, D majuscule et dom pour le jour, chacun sous forme d'entiers dans les plages attendues, le jour étant vérifié par rapport à la véritable longueur de ce mois y compris février bissextile grégorien. Lorsque seule l'année est présente, zodiac_year égale year et l'animal suit index égal année moins quatre modulo douze, avec Rat à zéro. Si la date d'entrée précède strictement ce jour de Nouvel An, before_new_year est vrai et zodiac_year devient année moins un ; le jour du Nouvel An et après, l'année civile garde son animal. Associez l'exécution gratuite dans le navigateur de cette page à l'API payante lorsque vous avez besoin du même animal au sein d'un pipeline automatisé sans réimplémenter vous-même les coupures luni-solaires.

Où les recherches du zodiaque chinois s'inscrivent dans la culture, le produit et le logiciel

Sur cette page, le travail s'exécute entièrement dans votre navigateur ; via l'API, chaque recherche réussie coûte $0.002, une validation échouée n'est pas facturée, et rien n'est conservé après le renvoi de la réponse. Cette séparation — exploration interactive gratuite et API payante identique — s'inscrit dans le reste du catalogue de niveau A du KIT et permet de passer d'une vérification ponctuelle de culture générale à un calendrier culturel pluriannuel sans changer le résultat mathématique.

Cas d'intégration

Fixtures culturelles déterministes

Générez des champs animal et chinese_new_year reproductibles pour tests unitaires, packs de localisation et assertions CI.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que signifie l'animal du zodiaque chinois et ce que contient la réponse

Où les recherches du zodiaque chinois s'inscrivent dans la culture, le produit et le logiciel

Cas d’usage

Étiquettes année-de-l'animal

Anniversaires proches du Nouvel An lunaire

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Limites

Erreurs

Notes techniques

Ce que signifie l'animal du zodiaque chinois et ce que contient la réponse

Comment year, month et day sont lus et comment la coupure reste reproductible

Où les recherches du zodiaque chinois s'inscrivent dans la culture, le produit et le logiciel

Cas d'intégration

Fixtures culturelles déterministes

merci