Compte long maya depuis une date
Ce convertisseur transforme une date grégorienne explicite en cinq positions du compte long maya : baktun, katun, tun, uinal et kin.
Lancer gratuitement
Il emploie la corrélation Goodman-Martinez-Thompson de 584,283 et interprète strictement l'entrée comme un jour civil UTC. Le résultat ne varie donc ni selon le fuseau horaire de l'appareil ni selon l'heure d'été. La réponse fournit aussi la notation pointée, le numéro du jour julien et le total de jours écoulés utilisé pour le calcul, afin que vous puissiez facilement contrôler, citer, tester ou intégrer la conversion.
Saisissez un jour grégorien précis
Indiquez la date au format strict YYYY-MM-DD, avec un zéro initial pour tout mois ou jour à un chiffre. Ainsi, le 21 décembre 2012 s'écrit 2012-12-21. Le convertisseur accepte les années 0001 à 9999 et applique le calendrier grégorien proleptique à toute cette période. Les règles grégoriennes habituelles des années bissextiles sont donc prolongées dans le passé, y compris avant l'adoption officielle de ce calendrier par les différents pays. L'entrée représente une date civile, et non un horodatage : elle ne comporte ni heure, ni décalage, ni lieu, ni passage à l'heure d'été, ni date actuelle implicite. Cette distinction garantit des appels répétables dans tous les environnements. Les dates impossibles telles que 2023-02-29, les valeurs mal formées, les horodatages et les dates absentes sont rejetés au lieu d'être corrigés silencieusement. Si votre source historique suit le calendrier julien, convertissez d'abord cette date vers le jour grégorien correspondant. Ce contrat explicite évite qu'une divergence de calendrier soit prise pour une erreur du calcul maya.
Comprenez la corrélation et le calcul
Toute conversion du compte long exige une corrélation entre la chronologie maya et le système de numéros de jours juliens utilisé par les calculs calendaires modernes. Cet outil annonce clairement son choix : la constante Goodman-Martinez-Thompson, dite GMT, de 584,283. Il convertit d'abord le jour grégorien proleptique fourni en un numéro entier de jour julien par arithmétique entière. Il soustrait ensuite 584,283 afin d'obtenir le nombre de kin écoulés depuis l'époque corrélée du compte long. Ce total est décomposé de la plus grande unité à la plus petite. Un baktun vaut 144,000 jours, un katun 7,200 jours, un tun 360 jours, un uinal 20 jours et un kin un jour. Le baktun n'est pas artificiellement remis à zéro après treize ; les dates postérieures à 13.0.0.0.0 restent donc ordonnées et sans ambiguïté. D'autres corrélations proposées par les chercheurs peuvent attribuer un compte long différent au même jour grégorien. Le libellé de corrélation et le numéro de jour julien renvoyés sont ainsi essentiels : ils précisent la convention utilisée et donnent des valeurs intermédiaires vérifiables indépendamment.
Interprétez et exploitez les champs renvoyés
Le résultat principal est la chaîne pointée long_count, organisée comme suit : baktun.katun.tun.uinal.kin. Ces cinq positions sont également fournies dans des champs entiers séparés, plus pratiques pour le tri, les modèles d'affichage, les colonnes de base de données ou des calculs supplémentaires. Le champ total_days représente tous les kin écoulés depuis l'époque corrélée choisie, tandis que julian_day_number conserve le numéro de jour intermédiaire de la date grégorienne. Le champ date reproduit exactement l'entrée validée et correlation identifie la constante GMT employée. L'implémentation n'effectue que des opérations entières bornées et ne consulte jamais d'horloge, d'analyseur de dates de la plateforme, de générateur aléatoire ou de service distant : une même entrée produit toujours le même JSON. Elle convient ainsi aux frises pédagogiques, catalogues de musées, notes de recherche reproductibles, jeux de test et chaînes API. La version dans le navigateur sert aux recherches ponctuelles ; chaque requête automatisée coûte $0.002. Conservez le libellé de corrélation lorsque vous publiez ou échangez un résultat, surtout face à une source susceptible d'utiliser une autre convention.
Cas d’usage
Annoter une chronologie historique
Ajoutez un compte long maya corrélé de façon cohérente aux dates grégoriennes d'une exposition, d'un article ou d'une frise pédagogique.
Contrôler des notices de catalogue
Recalculez les comptes longs pointés depuis les dates grégoriennes enregistrées et conservez la corrélation et le jour julien pour l'audit.
Créer des jeux de dates reproductibles
Produisez des exemples déterministes de conversion calendaire pour des tests logiciels, sans dépendre du fuseau horaire ni de l'analyseur système.
Questions fréquentes
Quelle corrélation maya ce convertisseur utilise-t-il ?
Il emploie la constante de corrélation Goodman-Martinez-Thompson 584,283 et indique cette convention dans chaque résultat.
Que représente chaque position ?
De gauche à droite : baktun, katun, tun, uinal et kin, soit des unités de 144,000, 7,200, 360, 20 et 1 jour.
Mon fuseau horaire modifie-t-il la réponse ?
Non. L'entrée est interprétée comme un jour civil UTC explicite et le calcul ne consulte ni horloge ni fuseau horaire local.
Pourquoi un autre convertisseur peut-il afficher une valeur différente ?
Il peut employer une autre constante, lire la source comme une date julienne plutôt que grégorienne, ou analyser un horodatage dans un fuseau local.
Quel est le prix d'une conversion par API ?
Chaque requête API coûte $0.002. Le convertisseur du navigateur permet des conversions ponctuelles sans appel à l'API.
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-long-count \
-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-long-count", {
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-long-count",
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-long-count", 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-long-count", 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_long_count",
"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. |