home-assistant.io/source/components/sun.markdown

layout, title, description, date, sidebar, comments, sharing, footer

layout	title	description	date	sidebar	comments	sharing	footer
page	Tracking the Sun	Instructions how to track the sun within Home Assistant.	2015-01-24 14:39	false	false	true	true

The `sun` component will use your current location to track if the sun is above or below the horizon. The sun can be used within automation as [a trigger with an optional offset to simulate dawn/dusk][automation-trigger].

# Example configuration.yaml entry
homeassistant:
  latitude: 32.87336
  longitude: -117.22743

sun:
  elevation: 123

Configuration variables:

• elevation (Optional): The solar elevation angle is the altitude of the sun. If ommitted will be retrieved from Google Maps.

{% linkable_title Implementation Details %}

The suns event listener will call the service when the sun rises or sets with an offset.

The sun event need to have the type 'sun', which service to call, which event (sunset or sunrise) and the offset.

{
    "type": "sun",
    "service": "switch.turn_on",
    "event": "sunset",
    "offset": "-01:00:00"
}

{% linkable_title Maintains entity sun.sun %}

Possible state	Description
above_horizon	When the sun is above the horizon.
below_horizon	When the sun is below the horizon.

State Attributes	Description
next_rising	Date and time of the next sun rising
next_setting	Date and time of the next sun setting