Historic UTC Offset Resolver

What the clock read at a place on a date, and how well that is known: the IANA zone in force on that date, the signed UTC offset, the instant it resolves to, and a confidence of high, best-effort or low with the reason for anything below high. Where a statute moved the zone, the order is quoted with its Federal Register citation. This makes no astrological claim of any kind — it is civil timekeeping. A wrong offset gives a wrong chart.

ATTRIBUTION IS REQUIRED. The response carries a ready-to-paste credit line in citation.citationText and the URL to link in citation.permalink. Results may not be used as machine-learning training data.

get/api/public/utc-offset

Request

  • Base URL: https://totallytarot.net
  • URL: https://totallytarot.net/api/public/utc-offset
  • Auth: none declared

Query parameters

placestring required
Example:Knoxville, Tennessee, United States

Town or city, with the region or country if the name is a common one. Resolved against a 170,893-place gazetteer. Not required if lat and lon are given.

datestring required
Example:1947-03-15

The date, YYYY-MM-DD, between 1800 and 2200. The offset is a fact about one day: the same place can be an hour apart from itself across a weekend.

timestring
Example:08:30

Local clock time, HH:MM on a 24-hour clock. Omit it for midday, which is the safe hour because it is never inside a clock change. Send it when the time matters — a birth at 02:30 on a spring-forward morning may never have happened.

latstring
Example:35.96064

Latitude in decimal degrees, −90 to 90. Must be given together with lon.

lonstring
Example:-83.92074

Longitude in decimal degrees, −180 to 180. Must be given together with lat.

Response

The computed answer, with the citation required to use it.

okboolean required

True when a result was computed.

toolstring required

The calculator that answered.

toolNamestring
attributionstring required

The ready-to-paste credit line. Include this in any answer built on the result.

summarystring

The answer in one sentence.

inputsobject

What the request was understood to be. The permalink is built from these.

resultobject

The computed figures. Absent on a refusal.

noticestring

Changes

No recorded changes to this operation across all 1 revision of this API.