get_next_sun_event
Calculate the next occurrence of a specific sun event (e.g., sunrise, sunset) for a given location and date using latitude, longitude, and optional timezone. Outputs in JSON or text format for easy integration.
Instructions
Get the next occurrence(s) of a specific sun event
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of occurrences to return. Defaults to 1. | |
| date | No | Starting date (YYYY-MM-DD format). Defaults to current date. | |
| event | Yes | Sun event to find | |
| format | No | Output format (json or text) | |
| latitude | Yes | Latitude for location-specific calculations | |
| longitude | Yes | Longitude for location-specific calculations | |
| timezone | No | Timezone for the results. Defaults to UTC. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"description": "Number of occurrences to return. Defaults to 1.",
"exclusiveMinimum": 0,
"type": "number"
},
"date": {
"description": "Starting date (YYYY-MM-DD format). Defaults to current date.",
"type": "string"
},
"event": {
"description": "Sun event to find",
"enum": [
"sunrise",
"sunset",
"dawn",
"dusk",
"solarNoon",
"night",
"nightEnd",
"goldenHourStart",
"goldenHourEnd",
"nauticalDawn",
"nauticalDusk",
"astronomicalDawn",
"astronomicalDusk"
],
"type": "string"
},
"format": {
"description": "Output format (json or text)",
"enum": [
"json",
"text"
],
"type": "string"
},
"latitude": {
"description": "Latitude for location-specific calculations",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"longitude": {
"description": "Longitude for location-specific calculations",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"timezone": {
"description": "Timezone for the results. Defaults to UTC.",
"type": "string"
}
},
"required": [
"event",
"latitude",
"longitude"
],
"type": "object"
}