Skip to content

Commit

Permalink
language
Browse files Browse the repository at this point in the history
  • Loading branch information
pilotak committed Jun 3, 2020
1 parent b03ee2b commit 1e6538b
Showing 1 changed file with 9 additions and 8 deletions.
17 changes: 9 additions & 8 deletions info.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
The `attributes` platform supports sensors which break out specified `attribute` from other entities.
# HomeAssistant component: `attributes`
The `attributes` platform supports sensors which break out a specified `attribute` from other entities.

To enable Attribute sensor in your installation, add the following to your `configuration.yaml` file:
To enable the `attributes` sensor in your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
Expand Down Expand Up @@ -28,12 +29,13 @@ Configuration variables:
- **entities** (*Required*): A list of entity IDs that you want to read attributes from.
- **attribute** (*Required*): Which attribute to extract from defined entity IDs.
- **frindly_name** (*Optional*): Name to use in the Frontend *(will be the same for all entities specified at the moment)*.
- **friendly_name** (*Optional*): Name to use in the Frontend *(will be the same for all entities specified at the moment)*.
- **icon** (*Optional*): Icon to use in the Frontend.
- **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any.
- **round_to** (*Optional*): round numbers to 'x' decimals, if zero it will become whole number. Skip this field if you extracting a string or you want to leave the value as it is.
- **time_format** (*Optional*): **`strftime`** type string to beautify time attribute output. Applicable only when attribute `last_changed` or `last_triggered` is selected. Cheatsheet for strftime formatting [here](http://strftime.ninja/).

This example shows how to extact `battery_level` attribute.
This example shows how to extract the `battery_level` attribute.

```yaml
sensor:
Expand All @@ -47,7 +49,7 @@ sensor:
- sensor.test3
```

>If an attribute is __`battery`__ or __`battety_level`__ and you don't specify __`icon`__ following icon_template is applied (fullness). The result is that battery icon become as full as battery based on percentage.
>If an attribute is __`battery`__ or __`battery_level`__ and you don't specify __`icon`__, the following icon_template is applied (fullness). The result is that the battery icon becomes as full as the battery based on percentage.

```yaml
{% if batt == 'unknown' %}
Expand Down Expand Up @@ -80,7 +82,7 @@ sensor:
```


This example shows how to extact `last_triggered` attribute in human readable format.
This example shows how to extract the `last_triggered` attribute in human-readable format.

```yaml
sensor:
Expand All @@ -92,5 +94,4 @@ sensor:
entities:
- automation.dummy_changed
```
>If you select attribute __`last_changed`__ or __`last_triggered`__ and you specify time_format your datetime will get translated to your local timezone and will be formatted like `strftime()` ie.: ***2017-08-08T13:14:21.651894+00:00*** gets translated into specified strftime format with timezone applied. Result would be ie.: ***8 August 15:14:21*** if you timezone is UTC+2

>If you select attribute __`last_changed`__ or __`last_triggered`__ and you specify time_format, your datetime will get translated to your local timezone and will be formatted like `strftime()` e.g., ***2017-08-08T13:14:21.651894+00:00*** gets translated into the specified strftime format with timezone applied. The result would be: ***8 August 15:14:21*** if your timezone is UTC+2

0 comments on commit 1e6538b

Please sign in to comment.