Estime a fase da Lua para qualquer data

Ele também informa a idade lunar aproximada, o percentual iluminado e a fração do ciclo. O cálculo é determinístico e utiliza um mês sinódico médio contado a partir de uma lua nova de referência conhecida. Não exige localização, acesso à rede, serviço astronômico nem armazenamento de dados do usuário, sendo útil para planejamento rápido e fluxos de software reproduzíveis.

Informe uma data gregoriana completa

Forneça a data exatamente no formato AAAA-MM-DD, incluindo zeros à esquerda em meses e dias de um só algarismo. Por exemplo, 8 de abril de 2024 deve ser escrito como 2024-04-08. O estimador valida o calendário gregoriano real, e não apenas o formato do texto, portanto rejeita valores impossíveis como 30 de fevereiro. Os anos bissextos seguem a regra padrão de divisibilidade por quatro, com a exceção dos séculos e a correção dos quatrocentos anos. O cálculo considera o meio-dia no tempo universal coordenado para a data solicitada. Isso oferece um ponto consistente de avaliação e impede que o resultado dependa silenciosamente do fuso horário do computador. Esta capacidade aceita anos de 0001 a 9999, representados por quatro dígitos. Ela não interpreta expressões informais, ordens regionais, carimbos de data e hora ou sufixos de fuso. Converta esses valores para o formato documentado antes da chamada. A entrada rigorosa torna as chamadas repetíveis e evita que uma data ambígua, como 03/04/2025, receba interpretações diferentes.

Entenda como a estimativa é calculada

O método parte de uma lua nova conhecida em 6 de janeiro de 2000, às 18:14 UTC, e converte a data solicitada em um dia juliano. Em seguida, determina o tempo transcorrido desde essa referência e reduz o resultado a um mês sinódico médio de 29.530588853 dias. A posição nesse intervalo recorrente é a fração do ciclo, enquanto a parte transcorrida aparece como idade lunar em dias. Oito rótulos conhecidos dividem o ciclo em faixas angulares iguais, centradas na lua nova, no quarto crescente, na lua cheia e no quarto minguante. A iluminação é estimada com uma curva de cosseno: começa perto de zero por cento na lua nova, aumenta até quase cem por cento na lua cheia e diminui novamente na metade minguante. Os valores são arredondados com precisão estável e útil. Trata-se de um modelo aritmético compacto, não de efemérides. Como a órbita real varia, uma observação astronômica precisa pode diferir em várias horas e indicar um rótulo vizinho perto da transição.

Use o resultado no nível correto de precisão

Use esta capacidade quando uma estimativa rápida e reproduzível for mais importante do que um horário de observatório. Calendários podem exibir um rótulo lunar reconhecível ao lado de eventos, projetos educacionais podem demonstrar o ciclo recorrente e ferramentas de planejamento podem orientar escolhas aproximadas sobre a luminosidade noturna. O campo de fase foi feito para categorização legível. A idade e a fração do ciclo servem melhor para ordenar, criar indicadores visuais ou comparar datas próximas, enquanto illumination_percent fornece uma estimativa intuitiva de brilho. Como o algoritmo recebe somente a data, ele não calcula nascer ou pôr da Lua, altitude, azimute, eclipses, visibilidade local, clima nem orientação aparente da parte iluminada. Essas questões exigem coordenadas geográficas, hora exata e dados orbitais detalhados. Não use a estimativa para navegação, segurança, publicação científica, determinações religiosas que exijam observação oficial ou eventos dependentes do instante exato da fase. Para consultas comuns e elementos visuais de aplicativos, ela é transparente, econômica e idêntica em todas as execuções. O navegador funciona sem chamada ao servidor, e cada solicitação automatizada à API custa US$ 0,002.