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
- Spain: the 105 municipalities that the National Geographic Institute (IGN) lists inside the path. We use the town centre from GeoNames where available, otherwise the centre of the municipality's area.
- Other countries: towns named in published eclipse guides, plus every GeoNames place with at least 15,000 people inside the path (up to 15 per country).
- Partial-eclipse cities: GeoNames places with at least 100,000 people in the United Kingdom, Ireland, the Netherlands and Belgium.
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.
- Spain: for the 105 IGN municipalities our duration is on average +1.5 s from the IGN value; 89 of 105 are within ±4 s and the largest difference is 17 s (at the edge of the path, where totality changes fastest).
- Partial eclipse: for 31 sample cities published by National Eclipse, our share of the Sun covered differs by at most 0.2 percentage points.
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.