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-13 20:36:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update sun elevation example to Home Assistant Documentation standards (#14284)

Browse Source
This commit is contained in:
tomlut 2020-09-05 17:29:01 +05:00 committed by GitHub
parent be43e746a3
commit e5dadeef57
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 15 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_docs/scripts/conditions.markdown
View File

@ -102,6 +102,7 @@ If both `below` and `above` are specified, both tests have to pass.
You can optionally use a `value_template` to process the value of the state before testing it. You can optionally use a `value_template` to process the value of the state before testing it.
{% raw %}
```yaml ```yaml
condition: condition:
condition: numeric_state condition: numeric_state
@ -109,8 +110,9 @@ condition:
above: 17 above: 17
below: 25 below: 25
# If your sensor value needs to be adjusted # If your sensor value needs to be adjusted
value_template: {% raw %}'{{ float(state.state) + 2 }}'{% endraw %} value_template: '{{ float(state.state) + 2 }}'
``` ```
{% endraw %}
It is also possible to test the condition against multiple entities at once. It is also possible to test the condition against multiple entities at once.
The condition will pass if all entities match the thresholds. The condition will pass if all entities match the thresholds.
@ -205,21 +207,25 @@ For an in-depth explanation of sun elevation, see [sun elevation trigger][sun_el
[sun_elevation_trigger]: /docs/automation/trigger/#sun-elevation-trigger [sun_elevation_trigger]: /docs/automation/trigger/#sun-elevation-trigger
{% raw %}
```yaml ```yaml
condition: condition:
condition: and # 'twilight' condition: dusk and dawn, in typical locations condition: and # 'twilight' condition: dusk and dawn, in typical locations
conditions: conditions:
- condition: template - condition: template
value_template: {% raw %}'{{ state_attr("sun.sun", "elevation") < 0 }}'{% endraw %} value_template: "{{ state_attr('sun.sun', 'elevation') < 0 }}"
- condition: template - condition: template
value_template: {% raw %}'{{ state_attr("sun.sun", "elevation") > -6 }}'{% endraw %} value_template: "{{ state_attr('sun.sun', 'elevation') > -6 }}"
``` ```
{% endraw %}
{% raw %}
```yaml ```yaml
condition: condition:
condition: template # 'night' condition: from dusk to dawn, in typical locations condition: template # 'night' condition: from dusk to dawn, in typical locations
value_template: {% raw %}'{{ state_attr("sun.sun", "elevation") < -6 }}'{% endraw %} value_template: "{{ state_attr('sun.sun', 'elevation') < -6 }}"
``` ```
{% endraw %}
#### Sunset/sunrise condition #### Sunset/sunrise condition
@ -273,11 +279,13 @@ A visual timeline is provided below showing an example of when these conditions
The template condition tests if the [given template][template] renders a value equal to true. This is achieved by having the template result in a true boolean expression or by having the template render 'true'. The template condition tests if the [given template][template] renders a value equal to true. This is achieved by having the template result in a true boolean expression or by having the template render 'true'.
{% raw %}
```yaml ```yaml
condition: condition:
condition: template condition: template
value_template: "{% raw %}{{ (state_attr('device_tracker.iphone', 'battery_level')|int) > 50 }}{% endraw %}" value_template: "{{ (state_attr('device_tracker.iphone', 'battery_level')|int) > 50 }}"
``` ```
{% endraw %}
Within an automation, template conditions also have access to the `trigger` variable as [described here][automation-templating]. Within an automation, template conditions also have access to the `trigger` variable as [described here][automation-templating].
@ -363,6 +371,7 @@ condition:
### Examples ### Examples
{% raw %}
```yaml ```yaml
condition: condition:
- condition: numeric_state - condition: numeric_state
@ -379,3 +388,4 @@ condition:
entity_id: script.light_turned_off_5min entity_id: script.light_turned_off_5min
state: 'off' state: 'off'
``` ```
{% endraw %}