Celestial Hours

Methodology

Calculation engine

Celestial Hours uses astronomy-engine (version ^2.1, source) for all solar calculations. This is a high-precision astronomical library that computes sunrise and sunset from the observer's geographic coordinates.

Convention:
Apparent upper-limb rise/set (standard horizon, refraction included by the library). No additional refraction or solar-radius correction is applied.
Elevation:
Observer height = 0 m. Not terrain- or building-adjusted observed sunrise.
Engine version:
celestial-hours/planetaryHours v1

Planetary hours

The planetary-day chart is anchored to the most recent sunrise at or before the target instant. The day is divided from sunrise to sunset into twelve equal day hours, and from sunset to the following sunrise into twelve equal night hours. Because daylight and nighttime durations vary by season and latitude, individual planetary hours are rarely exactly 60 clock minutes.

The first hour of each day is ruled by the planet governing that weekday (Sunday → Sun, Monday → Moon, Tuesday → Mars, Wednesday → Mercury, Thursday → Jupiter, Friday → Venus, Saturday → Saturn). Subsequent hours follow the Chaldean order: Saturn → Jupiter → Mars → Sun → Venus → Mercury → Moon, repeating continuously through the sunset transition.

Time zones

All times are displayed in the IANA time zone associated with your selected location. Calculations are performed in UTC and converted for display. When you enter manual coordinates, you must also select an IANA time zone, because geographical zone resolution from coordinates alone is not always accurate (especially near zone boundaries and in regions with fractional UTC offsets).

Limitations

  • Polar regions may have no sunrise or sunset on a given date; the chart reports unavailable in those cases.
  • Observer elevation is fixed at 0 m; local terrain and buildings can shift observed sunrise by minutes.
  • Daylight Saving Time transitions are handled automatically by the IANA time-zone database.
  • Traditional associations are historical, not scientific guarantees of outcome.

Verification

The engine has been tested against independent sunrise/sunset calculations, all seven weekday rulers, continuous Chaldean sequence through sunset, boundary behavior, before-sunrise anchoring, DST transitions, and polar day/night. See the Sources page for the status of historical reference review.