How we calculate eclipse times

Updated 19 November 2026

Every number on EclipseTowns is calculated, not copied. This page explains how, where the inputs come from and how close our values are to official ones.

The calculation

We use Astronomy Engine (MIT licence), an open-source astronomy library, to find the local circumstances of the eclipse for each place: the four contacts (start and end of the partial phase, start and end of totality), the moment of maximum eclipse, the share of the Sun's area covered (obscuration) and the Sun's altitude at each moment. The Sun's compass direction at maximum comes from the same library.

Calculations are for sea level at the place's coordinates. Height above sea level and the irregular edge of the Moon change contact times by a few seconds, most of all near the edge of the path.

Places and coordinates

200 of 207 places in the path use GeoNames coordinates (GeoNames, CC BY 4.0). In all, the site covers 335 places.

The path of totality

The map band is calculated the same way: we scan 641 meridians from -12° to 52° longitude and find the northern and southern limits of totality on each. The centre line is the midpoint. On our centre line the longest totality is 6m 27s; the published maximum for the eclipse is 6m 23s.

How accurate is it?

We compare our values with reference values on every build, and the build stops if a value falls outside our tolerance.

Near the edge of the path, totality can change by several seconds per kilometre. Pages for those towns carry an edge warning.

Time zones

Local times use each country's legal time on 2 August 2027. Morocco returned to GMT (UTC+0) as its legal time on 20 September 2026, so Moroccan times are in GMT. Saudi Arabia, Yemen and Somalia use UTC+3; Egypt observes summer time (UTC+3) in August.

What we do not do

We do not publish viewing spots, travel times, prices or crowd forecasts unless they come from a named source. Weather statistics will come from NASA POWER long-term data and are never forecasts.

Found an error? Tell us.