get_earth_seasons
Calculate Earth's seasonal and orbital events for any year, including equinoxes, solstices, perihelion, and aphelion with timezone support.
Instructions
Get Earth's seasons and orbital events for a year.
Returns dates and times for equinoxes (equal day/night), solstices (longest/shortest days), and Earth's perihelion (closest to sun) and aphelion (farthest from sun).
Args: year: Year to query (1700-2100) timezone: Timezone offset from UTC in hours. If not provided, UTC (0) is used. dst: Whether to apply daylight saving time adjustment.
Returns: SeasonsResponse with equinoxes, solstices, perihelion, and aphelion.
Tips for LLMs: - Typically 6 events per year (2 equinoxes, 2 solstices, perihelion, aphelion) - Seasons are opposite in Northern and Southern hemispheres - Earth's 23.5 degree axial tilt causes seasons, not distance from sun
Example: seasons = await get_earth_seasons(2024) for event in seasons.data: print(f"{event.phenom}: {event.month}/{event.day}/{event.year} at {event.time}")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| timezone | No | ||
| dst | No |