Calculateur du cycle calendaire maya par date
Ce calculateur du cycle calendaire maya convertit une date grégorienne explicite en positions Tzolkin et Haab combinées.
Lancer gratuitement
Tout se passe dans votre navigateur : gratuit, sans envoi de vos données.
Il applique la constante de corrélation Goodman-Martinez-Thompson 584283 et uniquement une arithmétique entière : le résultat ne dépend donc ni de l’horloge de l’appareil, ni du fuseau horaire, ni de l’heure d’été, ni de données en ligne. La réponse indique le numéro et le nom du jour Tzolkin, le jour et le mois Haab, leur désignation combinée ainsi que le numéro de jour julien employé, afin que vous puissiez contrôler ou reproduire le calcul.
Ce que représente le cycle calendaire maya
Le cycle calendaire réunit deux cycles récurrents du calendrier maya. Le Tzolkin compte 260 jours, obtenus en associant treize numéros de jour à vingt noms. Puisque les deux séries progressent ensemble, une désignation Tzolkin donnée réapparaît au bout de 260 jours. Le Haab est un cycle civil de 365 jours, composé de dix-huit mois de vingt jours puis de Wayeb, une courte période finale de cinq jours. Une même paire Tzolkin-Haab revient après 18,980 jours, soit 52 années Haab. Ce calculateur fournit les deux positions au lieu de présenter l’une d’elles comme une date complète à long terme. Cette nuance est fondamentale : une désignation du cycle calendaire situe un jour dans un cycle répétitif, mais n’identifie pas à elle seule une journée unique dans toute l’histoire. La réponse reprend donc aussi la date ISO saisie et son numéro de jour julien. Ces informations permettent de vérifier la conversion et empêchent de confondre l’étiquette récurrente avec une date unique du Compte long. Les graphies retenues sont courantes dans les études mayanistes, notamment Ajaw, Kankin et Wayeb.
Comment la conversion reste déterministe
Saisissez une date grégorienne au format exact YYYY-MM-DD. Avant toute conversion, le calculateur contrôle le mois, le jour et les règles grégoriennes relatives aux années bissextiles. Il transforme ensuite la date en un numéro entier de jour julien au moyen de l’arithmétique du calendrier grégorien proleptique. Aucun objet Date de JavaScript n’est créé : un navigateur à Tokyo, un serveur en UTC et un ordinateur à New York suivent ainsi le même chemin et produisent la même valeur. La position maya est ancrée sur la constante de corrélation Goodman-Martinez-Thompson 584283, généralement abrégée GMT. À l’origine de cette corrélation, les décalages des cycles correspondent à 4 Ajaw et 8 Kumku ; l’arithmétique modulaire les fait avancer jusqu’au jour demandé. Les restes négatifs sont normalisés explicitement, de sorte que les dates antérieures à l’origine restent elles aussi définies dans la plage grégorienne prise en charge. La réponse précise la corrélation choisie, car ce choix constitue une hypothèse d’interprétation et non un détail technique invisible. Une publication fondée sur une autre corrélation peut donc donner un résultat différent tout en restant cohérente dans son propre système.
Lire et exploiter le résultat avec discernement
Lisez le champ calendar_round en commençant par le Tzolkin, puis le Haab. Ainsi, 4 Ajaw / 3 Kankin désigne le numéro 4 du Tzolkin associé au nom de jour Ajaw, puis le jour 3 du mois Haab Kankin. Les objets imbriqués tzolkin et haab conviennent mieux aux logiciels qui ont besoin de valeurs séparées, tandis que la chaîne combinée se prête à l’affichage, aux notes ou à la préparation d’une référence. Servez-vous de julian_day_number pour comparer cette réponse à celle d’un autre convertisseur : si les numéros de jour coïncident mais que les positions mayas diffèrent, la cause est généralement une autre corrélation ou convention de décalage. Le calcul applique le calendrier grégorien proleptique sur toute la plage admise, y compris avant l’adoption historique du calendrier grégorien dans un pays donné. Cette convention assure un calcul uniforme, mais peut différer d’une date notée selon le calendrier julien dans une source ancienne. Cet outil calcule des positions calendaires ; il n’authentifie pas une inscription, ne déduit pas un Compte long, ne tranche pas les débats archéologiques et ne prétend pas fournir une interprétation culturelle. Pour vos recherches, conservez ensemble la date ISO, la corrélation GMT 584283 et les champs retournés.
Cas d’usage
Vérifier une conversion publiée
Comparez un article ou un cartel d’exposition à un calcul transparent fondé sur GMT 584283, puis conservez le jour julien pour vérification.
Enrichir une donnée datée
Ajoutez des champs Tzolkin et Haab structurés à une note de recherche, une frise pédagogique ou un jeu de données daté au format ISO.
Créer un affichage calendaire reproductible
Produisez une désignation stable sans dépendre du fuseau de l’appareil, de l’heure courante, d’une consultation distante ou d’un analyseur local de dates.
Questions fréquentes
Quelle corrélation maya ce calculateur utilise-t-il ?
Il emploie la constante de corrélation Goodman-Martinez-Thompson 584283 et la mentionne dans chaque résultat.
Une date du cycle calendaire est-elle unique ?
Non. La même combinaison Tzolkin-Haab revient tous les 18,980 jours ; elle ne désigne donc pas à elle seule une journée historique unique.
Mon fuseau horaire modifie-t-il la réponse ?
Non. L’entrée est une date explicite et l’algorithme utilise une arithmétique entière, sans conversion d’horloge locale ni de fuseau.
Quelles dates grégoriennes sont acceptées ?
Utilisez exactement le format YYYY-MM-DD, de 0001-01-01 à 9999-12-31. La longueur des mois et les années bissextiles grégoriennes sont contrôlées.
Cet outil calcule-t-il le Compte long maya ?
Non. Il fournit les positions Tzolkin et Haab combinées et le jour julien nécessaire à leur vérification, mais il ne déduit aucun Compte long.
Combien coûte une requête API ?
Chaque requête API coûte $0.002. Le calcul traite une date comme un seul élément.
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
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/maya-calendar-round \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2012-12-21"}'const res = await fetch("https://api.kit.forhosting.com/date/maya-calendar-round", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2012-12-21"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/maya-calendar-round",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2012-12-21"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/maya-calendar-round", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2012-12-21"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2012-12-21"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/maya-calendar-round", 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
{
"date": "2012-12-21"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.maya_calendar_round",
"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
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. |