get_solar_eclipses_by_year
Find all solar eclipses worldwide for any year between 1800 and 2050. Get dates and types of total, annular, partial, and hybrid eclipses to plan observations.
Instructions
Get a list of all solar eclipses occurring in a specific year.
Returns all solar eclipses (total, annular, partial, and hybrid) that occur worldwide in the specified year. Use this to find eclipse dates, then use get_solar_eclipse_by_date to get detailed local circumstances.
Args: year: Year to query (1800-2050)
Returns: SolarEclipseByYearResponse with list of eclipse events.
Tips for LLMs: - Most years have 2 solar eclipses, some have 3, rarely 4 - After finding an eclipse date, use get_solar_eclipse_by_date to check visibility
Example: eclipses = await get_solar_eclipses_by_year(2024) for eclipse in eclipses.eclipses_in_year: print(f"{eclipse.event} on {eclipse.year}-{eclipse.month}-{eclipse.day}")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes |