jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add offset instructions to automation trigger (#26963)

Browse Source 
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Robert Lagus 2023-04-25 09:26:08 +02:00 committed by GitHub
parent 8f1cf94b9f
commit 28b13f9408
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
source/_integrations/sun.markdown
View File

@ -51,23 +51,25 @@ sun:
<img src='/images/screenshots/more-info-dialog-sun.png' />
</p>
## Implementation Details
## Automation trigger
The sun's 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.
The sun trigger need to have the type 'sun', which event (sunset or sunrise) and an optional offset.
```json
{
"type": "sun",
"service": "switch.turn_on",
"event": "sunset",
"offset": "-01:00:00"
}
```yaml
trigger:
- platform: sun
event: sunrise
offset: "-01:00:01"
```
| Key name | Description |
| --------- | ----------- |
| `event` | Possible values: `sunset` or `sunrise`
| `offset` | An optional offset for the sun event trigger, in a positive or negative number of seconds, or specified in `HH:MM:SS` (after sun event trigger) or `-HH:MM:SS` (before sun event trigger).
### Maintains entity `sun.sun`
| Possible state | Description |