Documentation / @interstellar-tools/equations / solarDayLength
Function: solarDayLength()
ts
function solarDayLength(P: number, T: number): number;Defined in: orbits/solar-day-length.ts:78
Compute the length of a solar day, sunrise to sunrise, from a body's rotation and its orbit.
Where:
is the sidereal rotation period, one turn against the stars, negative for a backwards spin is the orbital period is the solar day
Units
- Inputs:
PandTin the same unit. - Output:
in that unit.
Notes
- The body moves along its orbit as it turns, so it has to turn a little further for the Sun to come back to the same place in its sky: Earth turns in 23 h 56 m 4 s, and its day is 24 h.
- A backwards spin, against the orbit, makes the solar day shorter than the rotation: Venus turns in 243 days, and its day is 117.
- A spin slower than the orbit makes the Sun go backwards across the sky. The day is still the time between two sunrises, so it's always positive.
- Take
and against the same reference: Earth's 23 h 56 m 4.0989 s turn against the stars goes with the sidereal year, and the 23 h 56 m 4.0905 s sidereal day, measured against the moving equinox, with the tropical year. Both give 86 400 s to within a millisecond. - The PLANETS and MOONS datasets give the orbital periods, and the rotation periods.
- The same formula gives the synodic month, new Moon to new Moon, from the Moon's orbit and Earth's.
In practiceMercury
175.94 days
From sunrise to sunrise, two of Mercury's years
Mercury turns three times for every two orbits, so the Sun takes two of its years to come back. Close to perihelion its orbit outruns its spin, and the Sun stops in the sky and goes back for a few days.
ts
solarDayLength(58.6462, 87.969); // ≈ 175.94 daysParameters
| Parameter | Type | Description |
|---|---|---|
P | number | Sidereal rotation period (finite, not 0, not equal to T), negative for a spin against the orbit. |
T | number | Orbital period, in the same unit as P (finite, > 0). |
Returns
number
The solar day, in the unit of P and T.
Throws
- If
PorTis not a finite number. - If
P = 0,T <= 0, orP = T(the body keeps one face to the Sun and has no solar day).
Example
ts
// Earth: a turn against the stars, and the sidereal year, in seconds
solarDayLength(86_164.0989, 365.256_363 * 86_400); // ≈ 86 400 s
// Mars: the sol
solarDayLength(88_642.663, 686.971 * 86_400); // ≈ 88 775.244 s
// Venus spins backwards, in days
solarDayLength(-243.0226, 224.701); // ≈ 116.75 d