geoprimsField-grade geospatial math

Moon phase and illumination

How much of the moon is lit at an instant, its phase angle, its age since the new moon, the phase it is in, and when the next new moon, first quarter, full moon, and last quarter fall

Experimental: not yet fully verified. How results are checked

50 percent of the moon is lit, 6.8days after the new moon

50 percent of the moon is lit, 6.8 days after the new moon.

Illuminated fraction
Phase
Phase angle
Elongation
Age
Next new moon
Provenance
Computed by
time.moon.phase 1.0.0, core 0.1.0
Model
The moon's and the sun's apparent places from ELP 2000-82B and VSOP87D; the elongation seen from the Earth, then the phase angle at the moon from Meeus 48.3, tan i = R sin psi / (delta - R cos psi), and the illuminated fraction (1 + cos i) / 2 (Meeus 48.2); the phases themselves where the elongation in apparent ecliptic longitude reaches 0, 90, 180, and 270 degrees, which is the definition the almanacs use
Accuracy
Within 1 minute of the US Naval Observatory at every one of its 208 published phase instants from 1995 to 2045, and over 99% of the disc lit at each of the 52 full moons among them
Notes
1 shown with the answer
Cites
Bureau des Longitudes, distributed by CDS Strasbourg, ELP 2000-82B lunar theory (Chapront-Touze and Chapront), VizieR catalog VI/79; Meeus, J., Willmann-Bell, Astronomical Algorithms; US Naval Observatory, Astronomical Applications Department, USNO Astronomical Applications API (rise, set, and twilight; moon phases)

Something look off?

Your values

Showing an example. Change anything.
More options 1
Run many at once from a CSV

Loading…

How we got thisFormula, worked example, sources, and proof

Model: The moon's and the sun's apparent places from ELP 2000-82B and VSOP87D; the elongation seen from the Earth, then the phase angle at the moon from Meeus 48.3, tan i = R sin psi / (delta - R cos psi), and the illuminated fraction (1 + cos i) / 2 (Meeus 48.2); the phases themselves where the elongation in apparent ecliptic longitude reaches 0, 90, 180, and 270 degrees, which is the definition the almanacs use

Show your work

  1. Elongation

    How far the moon is ahead of the sun in apparent ecliptic longitude

    at 2026-06-21T22:30:00Z = 90.29 degrees, so first-quarter

  2. Phase angle

    Meeus 48.3: tan i = R sin psi / (delta - R cos psi)

    elongation 90.29 degrees = 89.57 degrees at the moon

  3. Illuminated fraction

    Meeus 48.2: k = (1 + cos i) / 2

    phase angle 89.57 degrees = 50 percent of the moon is lit, 6.8 days after the new moon

The same steps an agent gets from the MCP server with explain: true.

Accuracy: Within 1 minute of the US Naval Observatory at every one of its 208 published phase instants from 1995 to 2045, and over 99% of the disc lit at each of the 52 full moons among them

When to use this: Use this to know how much moonlight there will be, or when the next full moon falls. Enter an instant in UTC. The tool returns the lit fraction of the disc, the phase angle, how many days old the moon is, the phase it is in, and the instants of the next four quarters.

Limitations: The illuminated fraction is of the disc as a geometric circle, which is not the same as how bright the moon looks: a full moon is far more than twice as bright as a half moon. The phase instants are geocentric, the almanac convention, and are the same for everyone on Earth. Phase names are the conventional eight, and the four quarters are instants, not days.

Worked example: The moon on 2026-06-21 at 22:30 UTC. Source: USNO rstt/oneday for 2026-06-21: 46% illuminated, with first quarter at 21:55Z that day.

You enter

UTC time
2026-06-21T22:30:00Z

You get

The moon's phase
50 percent of the moon is lit, 6.8 days after the new moon
Illuminated fraction
0.504
Phase
First quarter
Phase angle
89.57°
Elongation
90.29°
Age
6.82 d
Next new moon
2026-07-14T09:43Z
Next first quarter
2026-07-21T11:05Z
Next full moon
2026-06-29T23:57Z
Next last quarter
2026-07-07T19:29Z

Review: Not yet independently reviewed by a geodesist.

Last verified: 2026-09-18, when a maintainer last confirmed this tool's sources at the issuer. See the sources ledger.

Status: version 1.0.0, core 0.1.0. See this tool in the verification report.

Changes

Checked against: 31 golden test vectors (download the test vectors, each with its source and tolerance). See how results are checked and every source.

Sources

Terms

IERS: International Earth Rotation and Reference Systems Service
The service that maintains the ITRF and Earth orientation data, and announces leap seconds in Bulletin C. Source: IERS Bulletin C (leap seconds)
TT: Terrestrial Time
The uniform time scale of astronomical ephemerides: TAI plus 32.184 seconds. Source: Espenak and Meeus Delta T polynomials
UT1: Universal Time 1
Time kept by Earth's actual rotation. It drifts against atomic time, and UTC is kept within 0.9 s of it. Source: IERS Bulletin C (leap seconds)
UTC: Coordinated Universal Time
The world's civil time standard, kept within 0.9 s of Earth's rotation by leap seconds. Aviation calls it Zulu time, written with a Z. Source: IERS Bulletin C (leap seconds)

Experimental means this tool has not yet met the stable bar: at least 20 golden vectors, differential tests, and an independent worked example.