2024年5月4日发(作者：)

value_template用法

value_template 是 Home Assistant 中用于在传感器、开关等实体

中情景地计算、转换值的一个模板功能。它允许用户使用 Jinja2 模板语

言对实体的属性进行计算、转换、提取或过滤，从而满足不同的需求。在

本文中，我将详细介绍 value_template 的用法，并提供一些示例来帮助

理解。

首先，让我们了解一下 value_template 的基本语法规则。

value_template 通常用于传感器或开关实体的配置中，其语法结构如下：

```

```

其中，`` 是一个合法的 Jinja2 表达式，可以对实体

的属性进行计算或转换。下面是一些常用的语法元素及其含义：

1. 变量：可以使用实体所提供的属性作为变量，并在表达式中进行

引用。例如，对于传感器实体，可以使用

`{{ state_attr('_id', 'attribute') }}` 来获取其属性

值。

2.运算符：支持多种运算符，如加法`+`、减法`-`、乘法`*`、除法

`/`、取余`%`、幂运算`**`、比较运算符`>`、`>=`、`<`、`<=`、`==`等。

3. 函数：可以使用内置的、或用户自定义的函数对数据进行处理。

Home Assistant 提供了许多有用的函数，如 `now(`（获取当前时间）、

`state_attr('...')`（获取属性值）、`max(`（获取最大值）、`min(`

（获取最小值）等。

4. 过滤器：可以使用内置的或用户自定义的过滤器对变量进行处理。

过滤器用于在 Jinja2 表达式中过滤、转换数据。例如，可以使用 `，

float` 将值转换为浮点数，或使用 `， round(1)` 将值四舍五入到小数

点后1位。

接下来，让我们来看一些具体的示例来说明 value_template 的用法。

1.温度传感器示例：

```yaml

sensor:

- platform: template

sensors:

living_room_temperature:

friendly_name: "Living Room Temperature"

```

这个示例中，我们创建了一个名为 `living_room_temperature` 的

传感器实体。它将通过 value_template 来计算 `_room`

实体的 `temperature` 属性，并将其转换为浮点数。这样，我们就可以

在 Home Assistant 中使用 `_room_temperature` 来获取

这个计算后的温度值。

2.开关示例：

```yaml

switch:

- platform: template

switches:

bedroom_light:

friendly_name: "Bedroom Light"

turn_on:

service: _on

entity_id: m

turn_off:

service: _off

entity_id: m

```

这个示例中，我们创建了一个名为 `bedroom_light` 的开关实体。

通过 value_template，它会根据 `m` 实体的状态来确定其

自身的开关状态。如果 `m` 的状态是 `on`，则

`bedroom_light` 的状态也是 `on`，反之同理。这个示例展示了

value_template 在开关组件中的用法。

除了这些基本用法外，value_template 还可以与传感器历史数据、

时间戳等配合使用来进行更复杂的计算。例如，可以通过

`y` 获取传感器的历史数据，并使用 value_template 来

计算一些时间范围内的平均值、最大值等等。

综上所述，value_template 是 Home Assistant 中一个非常有用的

功能，它可以让用户根据自己的需求对实体的属性进行计算、转换、提取

或过滤。通过合理的使用 value_template，可以为用户带来更加智能和

个性化的控制体验。