跳转到内容

Uptime 文本传感器

uptime 文本传感器提供从开机以来的时间的人类可读表示。 各元素可以用自定义字符串分隔,如果零值对应的元素将被省略。例如, 如果正常运行时间为 1 天、2 小时、3 分钟和 4 秒,传感器将报告 1d2h3m4s(使用默认 配置)。默认情况下,输出中前面的零元素将被修剪,例如,如果正常运行时间为 0 天、0 小时、3 分钟和 0 秒,传感器将报告 3m0s。 通过将 expand 设为 true 可以禁用此行为。

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

  • format(可选,list):允许自定义输出格式。可用选项如下:

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

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