Moon Phase Software

Tools & method

Moon phase calculation methods

Moon phase is not stored as a label on a calendar. It is calculated for an instant from the changing geometry of the Sun, Earth, and Moon. The phase calculator first resolves the submitted civil date, clock time, and IANA time zone to UTC, then evaluates the lunar state at that single instant.

This method hub separates two related but noninterchangeable questions. Phase angle and illumination describe geometry and visible fraction at the instant. Lunar age measures elapsed time from a searched new-Moon event. Keeping those operations separate prevents a rounded phase name or a mean month length from being treated as the underlying calculation.

How this calculation is divided

The engine evaluates a continuous phase angle through a 360-degree cycle and a separate illuminated fraction. Human-readable names such as waxing gibbous are display bands placed over that continuous result; the four principal phases are event searches at defined angular targets.

Age requires another search. The calculation locates the strictly preceding new Moon and subtracts its instant from the requested instant. Adjacent events are searched in both directions, so the returned previous and next timestamps bracket the input rather than being estimated from a fixed calendar interval.

Two technical guides

Scope boundaries

Use the working calculation

Open the Moon Phase Calculator to evaluate another exact instant with the production logic described here. For the shared time model, accuracy policy, and supported era, return to the methodology overview. The implementation and independent references are listed on the sources page.