Sign in
latestOpenAPI 3.1.02026-08-237602082.8 MB

529d7d36d7d6

Calendar & Cycles

Planetary Hours

Chaldean planetary hours for a date and place: 12 from sunrise to sunset and 12 from sunset to sunrise, so an hour is rarely 60 minutes. startHour and endHour are decimal local hours. Send atLocalHour (decimal local time, e.g. 15.2 for 15:12) to have the hour containing it marked isCurrent; without it no hour carries the field, because the answer is cacheable and a flag from the server clock would be stale by the time it renders. sunTimes.polarState is normal, polar-day or polar-night, and in the two polar cases there is nothing to divide, so hours comes back empty with a warning saying why.

post/planetary-hours

Request body

datestring required
latitudenumber nullable required
longitudenumber nullable required
timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

atLocalHournumber

Local time of day in decimal hours, e.g. 15.2 for 15:12. When sent, the hour containing it carries isCurrent: true and every other hour carries false. When omitted, no hour carries the field at all: it is not false, it is unasked.

Example request

{
  "atLocalHour": 15.2
}

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}