ForHosting KIT · Utilidades de desarrollo

Cuenta Larga maya desde una fecha

Este conversor transforma una fecha gregoriana explícita en las cinco posiciones conocidas de la Cuenta Larga maya: baktún, katún, tun, uinal y kin.

● BetaGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Utiliza la correlación Goodman-Martínez-Thompson de 584,283 y trata la entrada estrictamente como un día civil UTC, por lo que el resultado no cambia según la zona horaria del dispositivo ni el horario de verano. La respuesta también incluye la notación con puntos, el número de día juliano y el total de días transcurridos empleado en el cálculo, para que usted pueda revisar, citar, probar o integrar fácilmente la conversión.

Introduzca un día preciso del calendario gregoriano

Indique la fecha en el formato estricto YYYY-MM-DD, con ceros iniciales para los meses o días de un solo dígito. Por ejemplo, el 21 de diciembre de 2012 se escribe 2012-12-21. El conversor admite años de 0001 a 9999 y aplica el calendario gregoriano proléptico en todo ese intervalo. Esto significa que las reglas gregorianas habituales de los años bisiestos se extienden hacia atrás, incluso a periodos históricos anteriores a la adopción oficial de ese calendario en distintos países. La entrada es una fecha civil, no una marca temporal: no contiene hora, desplazamiento, ubicación, transición de horario de verano ni un día actual implícito. Esta distinción hace que las consultas repetidas sean estables en cualquier entorno. Las fechas imposibles, como 2023-02-29, los valores mal formados, las marcas temporales y las fechas ausentes se rechazan en lugar de normalizarse silenciosamente. Si su fuente histórica emplea el calendario juliano, convierta primero esa fecha al día gregoriano correspondiente. Este contrato explícito evita confundir una discrepancia de calendario con un error del cálculo maya.

Comprenda la correlación y el cálculo

Una conversión de la Cuenta Larga requiere correlacionar la cronología maya con el sistema de números de día juliano utilizado en los cálculos calendáricos modernos. Esta herramienta declara claramente su elección: la constante Goodman-Martínez-Thompson, o GMT, de 584,283. Primero convierte el día gregoriano proléptico indicado en un número entero de día juliano mediante aritmética entera. Después resta 584,283 para obtener el número de kin transcurridos desde la época correlacionada de la Cuenta Larga. Ese total se descompone de la unidad mayor a la menor. Un baktún equivale a 144,000 días; un katún, a 7,200; un tun, a 360; un uinal, a 20; y un kin, a un día. El valor del baktún no vuelve artificialmente a cero después de trece, de modo que las fechas posteriores a 13.0.0.0.0 siguen ordenadas y no son ambiguas. Otras propuestas académicas de correlación pueden asignar una Cuenta Larga diferente al mismo día gregoriano. Por eso importan la correlación y el número de día juliano devueltos: indican exactamente qué convención produjo el resultado y permiten verificar los pasos intermedios de forma independiente.

Interprete y utilice los campos devueltos

El resultado principal es la cadena long_count con puntos, ordenada como baktun.katun.tun.uinal.kin. Las mismas cinco posiciones se devuelven también como campos enteros independientes, algo más práctico para ordenar, crear plantillas de presentación, guardar columnas de base de datos o realizar cálculos posteriores. El campo total_days contiene el total de kin transcurridos desde la época correlacionada elegida, mientras que julian_day_number registra el número de día intermedio de la fecha gregoriana. El campo date repite exactamente la entrada validada y correlation identifica la constante GMT utilizada. Como la implementación realiza operaciones enteras acotadas y nunca consulta un reloj, analizador de fechas de plataforma, generador aleatorio ni servicio remoto, una entrada idéntica siempre produce el mismo JSON. Resulta apropiada para cronologías educativas, catálogos de museos, notas de investigación reproducibles, datos de prueba y procesos de API. La versión del navegador sirve para consultas individuales, mientras que las solicitudes automatizadas cuestan $0.002 cada una. Conserve la etiqueta de correlación al publicar o intercambiar un resultado, especialmente si lo compara con una fuente que pueda aplicar otra convención.

Qué puede hacer con ella

Anotar una cronología histórica

Añada una Cuenta Larga maya correlacionada de manera uniforme junto a las fechas gregorianas de una exposición, artículo o cronología didáctica.

Validar registros de catálogo

Vuelva a calcular las notaciones de Cuenta Larga desde fechas gregorianas almacenadas y conserve la correlación y el día juliano para auditoría.

Crear datos de fecha reproducibles

Genere ejemplos deterministas de conversión calendárica para pruebas de software sin depender de zonas horarias ni analizadores de fecha del sistema.

Preguntas frecuentes

¿Qué correlación maya utiliza este conversor?

Utiliza la constante de correlación Goodman-Martínez-Thompson 584,283 e identifica esa convención en cada resultado.

¿Qué significa cada posición?

De izquierda a derecha son baktún, katún, tun, uinal y kin: unidades de 144,000, 7,200, 360, 20 y 1 día, respectivamente.

¿Mi zona horaria modifica la respuesta?

No. La entrada se interpreta como un día civil UTC explícito y el cálculo no consulta el reloj ni la zona horaria local.

¿Por qué otro conversor podría mostrar un valor diferente?

Puede usar otra constante de correlación, interpretar la fuente como una fecha juliana en vez de gregoriana o analizar una marca temporal en una zona local.

¿Cuánto cuesta una conversión mediante API?

Cada solicitud de API cuesta $0.002. El conversor del navegador permite realizar conversiones individuales sin llamar a la API.

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

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

¿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-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)

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.maya_long_count",
  "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

Por solicitud$0.002

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.

Ver la documentación completa del KIT →