ASTROCLOCK

Eclipses & How AstroClock Calculates Them

Last updated: 2026-08-14

Eclipses have fascinated astronomers and astrologers for thousands of years. They occur only when the Sun, Moon, and Lunar Nodes align closely enough for the shadow geometry of the Earth-Moon system to become visible.

AstroClock does not rely on preloaded eclipse tables or static event databases. Instead, every New Moon, Full Moon, Solar Eclipse, and Lunar Eclipse is calculated dynamically from Swiss Ephemeris planetary positions using phase-angle detection, binary-search refinement, and lunar-node analysis.

What is an Eclipse?

An eclipse occurs when the Sun, Moon, and Lunar Nodes align closely on the ecliptic. Because the Moon's orbit is tilted relative to the Earth's orbital plane, most New Moons and Full Moons do not produce eclipses.

Only when a lunation takes place near the Lunar Node axis (Rahu/Ketu in astrology) does an eclipse become possible.

In astrology, the Lunar Nodes are commonly known as Rahu (North Node) and Ketu (South Node).

How AstroClock Finds New Moons

AstroClock continuously calculates the ecliptic longitudes of the Sun and Moon using Swiss Ephemeris.

The Moon phase angle is computed as:

Phase Angle =
(Moon Longitude - Sun Longitude) mod 360°

A New Moon occurs when:

Phase Angle = 0°

During the annual scan AstroClock searches for transitions:

359° → 0° → 1°

Once detected, a precision refinement process determines the exact instant of conjunction between the Sun and Moon.

How AstroClock Finds Full Moons

Full Moons are detected using the same phase-angle system.

AstroClock searches for:

Phase Angle = 180°

Meaning the Moon is positioned opposite the Sun.

179° → 180° → 181°

As with New Moons, a refinement process determines the precise Full Moon moment rather than using an approximate time window.

Precision Refinement

AstroClock initially scans the year in 6-hour increments for efficiency.

Once a New Moon or Full Moon crossing is found, the software performs a binary search refinement.

Each iteration halves the time interval until the exact phase crossing is isolated.

6h window
↓
3h
↓
1h30m
↓
45m
↓
22m
↓
...

This produces minute-level precision while maintaining excellent performance even on mobile devices.

Solar Eclipse Detection

After AstroClock identifies a New Moon, it measures the distance between the Sun and the Lunar Node axis.

If the Sun lies sufficiently close to either Rahu or Ketu, the event is classified as:

☉ Solar Eclipse

Otherwise the event is recorded as a normal:

🌑 New Moon

This mirrors the astronomical requirement that solar eclipses can only occur during New Moons near the nodes.

Lunar Eclipse Detection

Lunar eclipses use the same logic.

After a Full Moon is located, AstroClock measures how close the Moon is to the Lunar Node axis.

If the distance falls below the eclipse threshold, the event is classified as:

☽ Lunar Eclipse

Otherwise the event remains:

🌕 Full Moon

Why Eclipse Times Differ from NASA

Some users compare AstroClock's eclipse times with NASA eclipse tables.

They are not always expected to be identical.

These two moments are close, but they are not necessarily the same event.

Small differences between AstroClock eclipse times and NASA greatest-eclipse times are therefore normal.

Key Events Timeline

AstroClock's Key Events calendar combines:

Each event displays:

The timeline automatically adapts to:

AstroClock calculates these events directly from astronomical positions instead of relying on a static event database, allowing future years to be generated dynamically with the same engine.

Related pages