跳到主要内容

统计卡片

统计卡片允许你显示实体的统计值。

对于支持统计的传感器,系统每5分钟收集一次统计数据。它会保留传感器在特定时期的最小值最大值平均值,或者计量实体的总和

如果你的传感器不支持统计功能,请检查以下内容。

温度传感器的统计卡片截图。

温度传感器的统计卡片截图。

要将统计卡片添加到你的用户界面:

  1. 在屏幕右上角,选择编辑按钮。

    • 如果这是你首次编辑仪表板,会出现编辑仪表板对话框。
      • 通过编辑仪表板,你将接管这个仪表板的控制权。
      • 这意味着当新的仪表板元素可用时,它将不再自动更新。
      • 一旦你接管控制权,你将无法让这个特定的仪表板恢复自动更新。不过,你可以创建一个新的默认仪表板。
      • 要继续,在对话框中,选择三点菜单,然后选择接管控制
  2. 添加卡片并自定义操作和功能到你的仪表板。

此卡片的所有选项都可以通过用户界面进行配置,但如果你想要更多的时间段选项,你将需要在yaml中定义它们。

配置变量

type 字符串 必填

statistic

entity 字符串 必填

具有统计功能的传感器的实体ID,或外部统计ID

stat_type 字符串 必填

要渲染的统计类型。min(最小值), max(最大值), mean(平均值), change(变化值)

name 字符串 (可选,默认:实体名称)

实体名称。

icon 字符串 (可选)

覆盖图标。

unit 字符串 (可选)

给数据的测量单位。

默认:实体提供的测量单位。

period 映射 必填

用于计算的时间段。见下文

theme 字符串 (可选)

使用任何已加载的主题覆盖此卡片的主题。有关主题的更多信息,请参阅前端文档

footer 映射 (可选)

要渲染的底部小部件。参见页脚文档

collection_key 字符串 (可选)

如果使用时间段:energy_date_selection,你可以设置一个自定义键来匹配energy-date-selection卡片的可选键。这通常不是必需的,但如果在同一视图上使用多个日期选择卡片,则可能很有用。参见能源文档

示例

或者,可以使用YAML配置卡片:

type: statistic
entity: sensor.energy_consumption
period:
calendar:
period: month
stat_type: change

时间段选项

可以通过4种不同的方式配置时间段:

日历

使用带有当前周期偏移的固定周期。

配置变量

period 字符串 必填

要使用的周期。day(日), week(周), month(月), year(年)

offset 整数 (可选)

当前周期的偏移量,0表示当前周期,-1表示上一个周期。

示例,上个月的能源消耗变化:

type: statistic
entity: sensor.energy_consumption
period:
calendar:
period: month
offset: -1
stat_type: change

固定时间段

指定一个固定的时间段,开始和结束是可选的。

配置变量

start 字符串 (可选)

时间段的开始

end 字符串 (可选)

时间段的结束。

示例,2022年的变化:

type: statistic
entity: sensor.energy_consumption
period:
fixed_period:
start: 2022-01-01
end: 2022-12-31
stat_type: change

示例,不指定开始或结束的所有时间变化:

type: statistic
entity: sensor.energy_consumption
period:
fixed_period:
stat_type: change

滚动窗口

配置变量

duration 映射 必填

时间段的持续时间

offset 映射 (可选)

当前时间的偏移量,0表示当前时间段,-1表示上一个时间段。

示例,1小时10分钟5秒的时间段,结束于现在之前的2小时20分钟10秒:

type: statistic
entity: sensor.energy_consumption
period:
rolling_window:
duration:
hours: 1
minutes: 10
seconds: 5
offset:
hours: -2
minutes: -20
seconds: -10
stat_type: change

动态日期选择

当放置在有能源日期选择卡片的视图上时,统计卡片可以链接显示从日期选择卡片上选择的时间段的数据。

日期选择器时间段的示例:

type: statistic
entity: sensor.energy_consumption
period: energy_date_selection
stat_type: change

相关主题