Calculadora de la rueda calendárica maya por fecha
Esta calculadora de la rueda calendárica maya convierte una fecha gregoriana explícita en sus posiciones combinadas del Tzolkin y el Haab.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Emplea la correlación Goodman-Martínez-Thompson de 584283 y opera con aritmética entera, por lo que el resultado no depende del reloj del dispositivo, la zona horaria, el horario de verano ni datos de red. La respuesta muestra el día numerado del Tzolkin, el día y mes del Haab, la designación conjunta y el número de día juliano utilizado, lo que permite comprobar o reproducir el cálculo.
Qué representa la rueda calendárica maya
La rueda calendárica combina dos ciclos repetitivos del calendario maya. El Tzolkin es un ciclo de 260 días que surge al emparejar trece números de día con veinte nombres. Como ambas secuencias avanzan juntas, una designación concreta del Tzolkin vuelve a aparecer después de 260 días. El Haab es un ciclo civil de 365 días compuesto por dieciocho meses de veinte días y Wayeb, un período final corto de cinco días. Una pareja determinada de Tzolkin y Haab se repite tras 18,980 días, equivalentes a 52 años Haab. Esta calculadora informa de ambas posiciones y no presenta ninguna de ellas como una fecha completa de larga duración. La diferencia es importante: la designación de la rueda calendárica señala un lugar dentro de un ciclo repetitivo, pero no identifica por sí sola un día único de toda la historia. Por eso la respuesta también conserva la fecha ISO introducida y su número de día juliano. Estos datos permiten auditar la conversión y evitan confundir la etiqueta recurrente con una fecha única de la Cuenta Larga. Las grafías utilizadas son formas habituales en estudios mayistas, como Ajaw, Kankin y Wayeb.
Cómo se obtiene una conversión determinista
Introduzca una fecha gregoriana con el formato exacto YYYY-MM-DD. Antes de convertirla, la calculadora valida el mes, el día y las reglas gregorianas de los años bisiestos. A continuación transforma la fecha en un número entero de día juliano mediante aritmética gregoriana proléptica. No se crea ningún objeto Date de JavaScript; por tanto, un navegador en Tokio, un servidor en UTC y un equipo en Nueva York siguen el mismo procedimiento y obtienen el mismo valor. La posición maya se fija con la constante de correlación Goodman-Martínez-Thompson 584283, que suele abreviarse GMT. En el origen de esa correlación, los desfases de los ciclos corresponden a 4 Ajaw y 8 Kumku; la aritmética modular los hace avanzar hasta el día solicitado. Los restos negativos se normalizan de manera explícita, de modo que las fechas anteriores al origen de la correlación también quedan bien definidas dentro del intervalo gregoriano admitido. El resultado indica la correlación elegida porque esta constituye una premisa interpretativa, no un detalle invisible del programa. Si una publicación utiliza otra correlación, puede ofrecer un resultado diferente aunque ambos cálculos sean coherentes internamente.
Cómo leer y utilizar el resultado con rigor
Lea el campo calendar_round con el Tzolkin primero y el Haab después. Por ejemplo, un valor como 4 Ajaw / 3 Kankin significa el número 4 del Tzolkin con el nombre de día Ajaw, combinado con el día 3 del mes Haab Kankin. Los objetos anidados tzolkin y haab resultan más adecuados para programas que necesitan campos separados, mientras que la cadena conjunta es práctica para mostrarla, incluirla en notas o preparar una cita. Use julian_day_number cuando compare esta respuesta con otra herramienta: si coinciden los números de día pero cambian las posiciones mayas, normalmente se debe a otra correlación o convención de desfase. El cálculo aplica el calendario gregoriano proléptico en todo el intervalo admitido, incluso antes de que cada país adoptara históricamente el calendario gregoriano. Así se mantiene una computación uniforme, aunque el resultado puede diferir de una fecha escrita en una fuente histórica según el calendario juliano. La herramienta calcula posiciones calendáricas; no autentica inscripciones, no deduce una Cuenta Larga, no resuelve debates arqueológicos ni atribuye una interpretación cultural. Para una investigación reproducible, conserve juntos la entrada ISO, la correlación GMT 584283 y todos los campos devueltos.
Qué puede hacer con ella
Comprobar una conversión publicada
Compare un artículo o rótulo de museo con un cálculo transparente basado en GMT 584283 y conserve el día juliano para su revisión.
Añadir contexto calendárico a un registro
Incorpore campos estructurados del Tzolkin y el Haab a una nota de investigación, una cronología educativa o un conjunto de datos con fechas ISO.
Crear una visualización reproducible
Genere una designación estable sin depender de la zona horaria del dispositivo, la hora actual, una consulta remota ni un analizador de fechas local.
Preguntas frecuentes
¿Qué correlación maya utiliza la calculadora?
Utiliza la constante de correlación Goodman-Martínez-Thompson 584283 y la identifica en cada resultado.
¿Es única una fecha de la rueda calendárica?
No. La misma combinación del Tzolkin y el Haab se repite cada 18,980 días, por lo que no identifica por sí sola un único día histórico.
¿Cambia la respuesta según mi zona horaria?
No. La entrada es una fecha explícita y el algoritmo aplica aritmética entera, sin conversiones de reloj local ni de zona horaria.
¿Qué fechas gregorianas se admiten?
Use el formato exacto YYYY-MM-DD desde 0001-01-01 hasta 9999-12-31. Se validan la duración de los meses y los años bisiestos gregorianos.
¿Calcula esta herramienta la Cuenta Larga maya?
No. Devuelve las posiciones combinadas del Tzolkin y el Haab e incluye el día juliano para poder auditar el cálculo, pero no deduce una Cuenta Larga.
¿Cuánto cuesta una solicitud API?
Cada solicitud API cuesta $0.002. El cálculo procesa una fecha como un solo elemento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"date": "2012-12-21"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.maya_calendar_round",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |