ForHosting KIT · Ferramentas para dev

Calculadora da data da próxima lua cheia

A calculadora estima a primeira lua cheia posterior à data informada por você. Ela usa uma lua nova fixa como referência e o mês sinódico médio, faz toda a aritmética de calendário em UTC e nunca consulta o relógio atual.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Assim, o resultado pode ser reproduzido em servidores, navegadores, dispositivos e fusos horários. A ferramenta é útil quando uma estimativa estável é mais importante do que a precisão de um observatório. Como a órbita lunar real varia, considere o dia retornado uma aproximação, não o horário oficial de um evento astronômico.

O que a data retornada significa

Informe uma data gregoriana no formato estrito YYYY-MM-DD. A calculadora interpreta a entrada como meia-noite UTC no início do dia e encontra o primeiro instante de lua cheia modelado que ocorre depois. A resposta informa a data UTC que contém esse instante. Portanto, “próxima” tem um sentido exato: se a lua cheia modelada ocorrer mais tarde no dia informado, a mesma data poderá ser retornada; um evento exatamente no limite não será aceito. O resultado é uma referência estável para calendários, não uma garantia de que a Lua parecerá totalmente cheia para todos os observadores na data civil local. A ferramenta também não calcula nascer da Lua, visibilidade, clima, altitude ou iluminação. Para um horário exato, consulte efemérides profissionais.

Como funciona o modelo de ciclo médio

O algoritmo começa com uma lua nova de referência em 2000-01-06 18:14 UTC e um mês sinódico médio de 29.530588853 dias. Metade desse período define a lua cheia de referência. A data gregoriana solicitada é convertida em um número inteiro de dias por regras aritméticas de anos bissextos e duração dos meses, sem usar o objeto Date do JavaScript. Em seguida, o cálculo determina quantos períodos completos são necessários para alcançar o primeiro instante posterior ao limite de entrada e converte o resultado novamente em data gregoriana. Todas as constantes e regras são fixas, portanto entradas iguais sempre geram saídas iguais. As lunações reais variam, então o resultado pode divergir de um almanaque astronômico oficial, principalmente perto de uma mudança de dia UTC.

Validação, automação e uso adequado

A entrada deve ser uma data real com ano de quatro dígitos entre 0001 e 9999, mês de dois dígitos e dia de dois dígitos. Datas impossíveis, como 30 de fevereiro, são rejeitadas em vez de normalizadas. O cálculo não usa rede, localidade do dispositivo, data atual, estado armazenado ou aleatoriedade. Isso permite que rotinas em lote, navegadores e testes reproduzam exatamente a mesma resposta. A saída também identifica o modelo, a duração do ciclo e a época de referência. Para automação via API, o preço-base por solicitação é US$ 0,002. Não use esta ferramenta em operações espaciais, navegação, observações científicas, prazos legais ligados a um calendário lunar oficial ou decisões religiosas dependentes de avistamento local; consulte a autoridade astronômica ou institucional responsável.

Casos de uso

Adicionar uma marca aproximada ao calendário

Coloque em um calendário ou plano editorial a próxima lua cheia modelada após a data de um evento.

Criar dados de teste determinísticos

Gere resultados lunares estáveis sem depender do relógio, de um fuso horário ou de efemérides externas.

Ensinar modelos periódicos de datas

Mostre como uma época de referência e um ciclo médio repetitivo são projetados em datas gregorianas.

Perguntas frequentes

Qual é a precisão da data?

É uma aproximação de ciclo médio e pode divergir de efemérides astronômicas oficiais, sobretudo perto de uma mudança de dia UTC.

O que significa depois da data informada?

A entrada representa a meia-noite UTC no início do dia, e o primeiro instante modelado de lua cheia estritamente posterior é escolhido.

O cálculo usa meu fuso horário?

Não. O limite de entrada e a data retornada são definidos em UTC para produzir resultados determinísticos.

Ele usa a data atual ou um serviço astronômico ao vivo?

Não. O cálculo usa apenas a entrada explícita, constantes fixas e aritmética do calendário gregoriano.

Quanto custa uma solicitação de API?

O preço-base é US$ 0,002 por solicitação. A execução no navegador pode usar o mesmo cálculo puro.

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

POSThttps://api.kit.forhosting.com/date/next-full-moon

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/next-full-moon \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

const res = await fetch("https://api.kit.forhosting.com/date/next-full-moon", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-07-25"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/next-full-moon",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-07-25"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/next-full-moon", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-07-25"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/next-full-moon", 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": "2026-07-25"
}

Exemplo de resposta

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

por chamadaUS$ 0,002

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.

Ver a documentação completa do KIT →