Sign in
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
}

Changes

Changed in 2 of the 13 revisions of this API.610

  • 529d7d36d7d6410See the full diff
    • ●

      removed the optional property data/dayHours from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/nightHours from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/sunrise from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/sunset from the response with the 200 status

      response-optional-property-removed

    • ○

      added the new optional request property atLocalHour

      new-optional-request-property

    • ○

      added the optional property data/date to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/dayOfWeek to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/dayRulerPlanetId to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/dayRulerPlanetName to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/hours to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/latitude to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/longitude to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/sunTimes to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property data/timezone to the response with the 200 status

      response-optional-property-added

  • e637d1a9911b2See the full diff
    • ●

      the timezoneOffset request property's max was set to 14.00

      request-property-max-set

    • ●

      the timezoneOffset request property's min was set to -14.00

      request-property-min-set