ForHosting KIT · Strumenti per sviluppatori

Calcolatore del ciclo calendariale maya per data

Questo calcolatore del ciclo calendariale maya converte una data gregoriana esplicita nelle posizioni abbinate di Tzolkin e Haab.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Utilizza la costante di correlazione Goodman-Martinez-Thompson 584283 e opera con aritmetica intera; il risultato non dipende quindi dall’orologio del dispositivo, dal fuso orario, dall’ora legale o da dati reperiti in rete. La risposta mostra numero e nome del giorno Tzolkin, giorno e mese Haab, la designazione combinata e il numero del giorno giuliano impiegato, così Lei può controllare o riprodurre il calcolo.

Che cosa rappresenta il ciclo calendariale maya

Il ciclo calendariale unisce due cicli ricorrenti del calendario maya. Il Tzolkin è un ciclo di 260 giorni, formato abbinando tredici numeri di giorno a venti nomi. Poiché le due sequenze avanzano insieme, una determinata designazione Tzolkin ricompare dopo 260 giorni. L’Haab è un ciclo civile di 365 giorni, composto da diciotto mesi di venti giorni seguiti da Wayeb, un breve periodo finale di cinque giorni. Una particolare combinazione di Tzolkin e Haab si ripete dopo 18,980 giorni, ossia 52 anni Haab. Questo calcolatore restituisce entrambe le posizioni e non considera nessuna delle due come una data completa su un arco storico esteso. La distinzione è essenziale: una designazione del ciclo calendariale identifica una posizione in un ciclo ricorrente, non un giorno unico nell’intera storia. Per questo la risposta include anche la data ISO inserita e il relativo numero del giorno giuliano. Tali campi rendono verificabile la conversione e impediscono di scambiare l’etichetta ricorrente per una data univoca del Conto Lungo. Le grafie adottate sono forme diffuse negli studi mayanistici, tra cui Ajaw, Kankin e Wayeb.

Come viene garantita una conversione deterministica

Inserisca una data gregoriana nell’esatto formato YYYY-MM-DD. Prima della conversione, il calcolatore verifica il mese, il giorno e le regole gregoriane per gli anni bisestili. Trasforma poi la data in un numero intero di giorno giuliano mediante aritmetica gregoriana prolettica. Non viene creato alcun oggetto Date di JavaScript: un browser a Tokyo, un server in UTC e un computer a New York seguono pertanto lo stesso procedimento e producono lo stesso valore. La posizione maya viene ancorata alla costante di correlazione Goodman-Martinez-Thompson 584283, comunemente abbreviata in GMT. All’origine della correlazione, gli scarti dei cicli corrispondono a 4 Ajaw e 8 Kumku; l’aritmetica modulare li fa avanzare fino al giorno richiesto. I resti negativi sono normalizzati in modo esplicito, mantenendo ben definite anche le date anteriori all’origine entro l’intervallo gregoriano supportato. Il risultato dichiara la correlazione selezionata perché si tratta di una premessa interpretativa, non di un dettaglio nascosto dell’implementazione. Se una pubblicazione adotta una correlazione diversa, può presentare un risultato differente benché entrambi i calcoli siano internamente coerenti.

Come leggere e utilizzare correttamente il risultato

Legga il campo calendar_round partendo dal Tzolkin e passando poi all’Haab. Per esempio, 4 Ajaw / 3 Kankin indica il numero 4 del Tzolkin con il nome del giorno Ajaw, abbinato al giorno 3 del mese Haab Kankin. Gli oggetti annidati tzolkin e haab sono preferibili per il software che richiede campi distinti, mentre la stringa combinata è pratica per la visualizzazione, gli appunti o la preparazione di un riferimento. Usi julian_day_number nel confronto con un altro strumento: numeri del giorno uguali ma posizioni maya diverse segnalano di solito una differente correlazione o convenzione di scarto. Il calcolo applica il calendario gregoriano prolettico all’intero intervallo supportato, comprese le date anteriori all’adozione storica del calendario gregoriano nei singoli paesi. Ciò rende uniforme il procedimento, ma può produrre una differenza rispetto a una data riportata secondo il calendario giuliano in una fonte storica. Lo strumento calcola posizioni calendariali; non autentica iscrizioni, non ricava un Conto Lungo, non risolve controversie archeologiche e non pretende di offrire un’interpretazione culturale. Per una ricerca riproducibile, conservi insieme l’input ISO, la correlazione GMT 584283 e tutti i campi restituiti.

Casi d'uso

Verificare una conversione pubblicata

Confronti un articolo o una didascalia museale con un calcolo trasparente basato su GMT 584283 e conservi il giorno giuliano per la verifica.

Aggiungere contesto a un dato cronologico

Associ campi strutturati Tzolkin e Haab a una nota di ricerca, una linea del tempo didattica o un dataset con date ISO.

Creare una visualizzazione riproducibile

Generi una designazione stabile senza dipendere dal fuso del dispositivo, dall’ora corrente, da una consultazione remota o da un analizzatore locale di date.

Domande frequenti

Quale correlazione maya utilizza il calcolatore?

Utilizza la costante di correlazione Goodman-Martinez-Thompson 584283 e la indica in ogni risultato.

Una data del ciclo calendariale è univoca?

No. La stessa combinazione di Tzolkin e Haab ricorre ogni 18,980 giorni e non identifica da sola un unico giorno storico.

Il mio fuso orario modifica la risposta?

No. L’input è una data esplicita e l’algoritmo impiega aritmetica intera, senza conversioni dell’orologio locale o del fuso.

Quali date gregoriane sono accettate?

Usi esattamente il formato YYYY-MM-DD, da 0001-01-01 a 9999-12-31. Vengono verificati durata dei mesi e anni bisestili gregoriani.

Questo strumento calcola il Conto Lungo maya?

No. Restituisce le posizioni abbinate di Tzolkin e Haab e include il giorno giuliano per la verifica, ma non ricava un Conto Lungo.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Il calcolo elabora una data come singolo elemento.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/date/maya-calendar-round

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo 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)

Esempio di richiesta

{
  "date": "2012-12-21"
}

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →