Contagem Longa maia a partir de uma data
Este conversor transforma uma data gregoriana explícita nas cinco posições conhecidas da Contagem Longa maia: baktun, katun, tun, uinal e kin.
Executar grátis
Ele usa a correlação Goodman-Martinez-Thompson de 584,283 e trata a entrada estritamente como um dia civil em UTC; por isso, o resultado não muda conforme o fuso horário do dispositivo nem o horário de verão. A resposta também inclui a notação pontuada, o número do dia juliano e o total de dias decorridos usado no cálculo, facilitando a conferência, citação, validação ou integração da conversão.
Informe um dia exato do calendário gregoriano
Forneça a data no formato estrito YYYY-MM-DD, com zeros à esquerda em meses ou dias de um algarismo. Por exemplo, 21 de dezembro de 2012 deve ser informado como 2012-12-21. O conversor aceita anos de 0001 a 9999 e aplica o calendário gregoriano proléptico em todo esse intervalo. Isso significa que as regras gregorianas usuais para anos bissextos são estendidas ao passado, inclusive para períodos anteriores à adoção oficial desse calendário em diferentes países. A entrada representa uma data civil, não um timestamp: não há hora, deslocamento, localidade, transição de horário de verão nem data atual implícita. Essa distinção mantém chamadas repetidas estáveis em qualquer ambiente. Datas impossíveis, como 2023-02-29, valores malformados, timestamps e datas ausentes são rejeitados, nunca normalizados silenciosamente. Se a sua fonte histórica usa o calendário juliano, converta primeiro a data de origem para o dia gregoriano correspondente. Esse contrato explícito impede que uma divergência de identificação do calendário pareça um erro no cálculo maia.
Entenda a correlação e o cálculo
Converter uma Contagem Longa exige correlacionar a cronologia maia com o sistema de números de dias julianos empregado nos cálculos de calendários modernos. Esta ferramenta declara claramente a opção adotada: a constante Goodman-Martinez-Thompson, ou GMT, de 584,283. Primeiro, ela converte o dia gregoriano proléptico informado em um número inteiro de dia juliano por meio de aritmética inteira. Em seguida, subtrai 584,283 para obter a quantidade de kin decorridos desde a época correlacionada da Contagem Longa. Esse total é decomposto da maior unidade para a menor. Um baktun corresponde a 144,000 dias; um katun, a 7,200; um tun, a 360; um uinal, a 20; e um kin, a um dia. O valor de baktun não é artificialmente reiniciado depois de treze, portanto datas posteriores a 13.0.0.0.0 continuam ordenadas e inequívocas. Outras propostas acadêmicas de correlação podem atribuir uma Contagem Longa diferente ao mesmo dia gregoriano. Por isso, o rótulo da correlação e o número do dia juliano retornados são importantes: eles indicam exatamente qual convenção gerou o resultado e fornecem valores intermediários para conferência independente.
Leia e aproveite os campos retornados
O resultado principal é a string pontuada long_count, ordenada como baktun.katun.tun.uinal.kin. As mesmas cinco posições também são retornadas em campos inteiros separados, mais adequados para ordenação, modelos de exibição, colunas de banco de dados ou cálculos posteriores. O campo total_days informa todos os kin transcorridos desde a época correlacionada escolhida, enquanto julian_day_number registra o número intermediário do dia da data gregoriana. O campo date repete exatamente a entrada validada, e correlation identifica a constante GMT utilizada. Como a implementação executa operações inteiras limitadas e nunca consulta relógio, parser de data da plataforma, gerador aleatório ou serviço remoto, entradas idênticas sempre produzem o mesmo JSON. Assim, ela atende a linhas do tempo educacionais, catálogos de museus, notas de pesquisa reproduzíveis, dados de teste e fluxos de API. A versão no navegador é útil para consultas individuais; solicitações automatizadas custam US$ 0,002 cada. Preserve o rótulo de correlação ao publicar ou trocar um resultado, sobretudo ao compará-lo com uma fonte que possa adotar outra convenção.
Casos de uso
Anotar uma linha do tempo histórica
Inclua uma Contagem Longa maia correlacionada de modo consistente ao lado de datas gregorianas em exposições, artigos ou cronologias didáticas.
Validar registros de catálogo
Recalcule notações pontuadas com base em datas gregorianas armazenadas e mantenha a correlação e o dia juliano para auditoria.
Criar dados de data reproduzíveis
Gere exemplos determinísticos de conversão de calendário para testes de software, sem depender do fuso horário nem do parser de datas do sistema.
Perguntas frequentes
Qual correlação maia este conversor utiliza?
Ele usa a constante de correlação Goodman-Martinez-Thompson 584,283 e identifica essa convenção em todos os resultados.
O que cada posição representa?
Da esquerda para a direita, elas são baktun, katun, tun, uinal e kin: unidades de 144,000, 7,200, 360, 20 e 1 dia, respectivamente.
Meu fuso horário altera a resposta?
Não. A entrada é interpretada como um dia civil UTC explícito, e o cálculo não consulta relógio nem fuso horário local.
Por que outro conversor pode exibir um valor diferente?
Ele pode usar outra constante de correlação, interpretar a fonte como data juliana em vez de gregoriana ou analisar um timestamp em um fuso local.
Quanto custa uma conversão pela API?
Cada solicitação de API custa US$ 0,002. O conversor no navegador permite fazer conversões individuais sem uma chamada de API.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"date": "2012-12-21"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.maya_long_count",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |