跳转到内容

运行时间文本传感器

uptime 文本传感器提供自启动以来时间的可读表示。各元素可以用自定义字符串分隔,如果更重要的元素为零则省略。例如, 如果运行时间是 1 天 2 小时 3 分钟 4 秒,使用默认配置时传感器将报告 1d2h3m4s。默认情况下,前导零元素会从输出中省略,例如,如果运行时间是 0 天 0 小时 3 分钟 0 秒,传感器将报告 3m0s。 可以通过设置 expandtrue 来禁用此行为。

# 示例配置条目
text_sensor:
- platform: uptime
name: Uptime
format:
separator: " "
days: "D"
  • update_interval (可选, 时间): 传感器报告间隔。默认为 30s

  • format (可选, 列表): 允许自定义输出格式。可用的选项有:

    • days (可选, string): 天元素使用的字符串。默认为 d
    • hours (可选, string): 小时元素使用的字符串。默认为 h
    • minutes (可选, string): 分钟元素使用的字符串。默认为 m
    • seconds (可选, string): 秒元素使用的字符串。默认为 s
    • separator (可选, string): 运行时间值之间使用的分隔符。默认为空字符串。
    • expand (可选, boolean): 如果设置,文本将始终包含所有元素,即使它们为零。默认为 false
  • 所有其他选项来自文本传感器

报告的运行时间分辨率由更新间隔决定。例如,如果更新间隔设置为 30 秒(默认值),运行时间将以分钟为单位报告。更频繁的更新将导致以秒为单位报告。