24 Solar Terms

The 24 solar terms (jieqi) of a year: the instant the Sun's apparent ecliptic longitude crosses each multiple of 15 degrees, in UTC, in Beijing time and, if a zone is given, in that zone, each with its uncertainty band in seconds. Instants come from our own table built from JPL's DE440 and DE441 ephemerides. A year in which any term's band holds a midnight, in Beijing or in the zone asked about, is reported as unverified, because that term's civil date is not established.

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/solar-terms

Request

  • Base URL: https://totallytarot.net
  • URL: https://totallytarot.net/api/public/solar-terms
  • Auth: none declared

Query parameters

yearstring required
Example:2026

The Gregorian year, YYYY, 1926 to 3026.

tzstring
Example:America/New_York

An IANA zone name, or a numeric UTC offset in hours, to give each term's local time as well.

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.