ForHosting KIT · Outils pour développeurs

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.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/date/maya-long-count

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é.

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"}'
{
  "date": "2012-12-21"
}
{
  "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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →