Estime a fase da Lua para qualquer data

Este estimador transforma uma data do calendário em uma descrição prática do ciclo lunar, como lua nova, crescente, quarto crescente, lua cheia ou minguante. 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.

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.