跳转到内容

模板日期时间

template 日期时间平台允许您使用 lambda 创建具有模板值的日期时间。

datetime:
# 示例日期
- platform: template
id: my_datetime_date
type: date
name: 选择日期
optimistic: yes
initial_value: "2024-01-30"
restore_value: true
# 示例时间
- platform: template
id: my_datetime_time
type: time
name: 选择时间
optimistic: yes
initial_value: "12:34:56"
restore_value: true
# 示例日期时间
- platform: template
id: my_datetime
type: datetime
name: 选择日期时间
optimistic: yes
initial_value: "2024-12-31 12:34:56"
restore_value: true
  • type (必填, enum):日期时间的类型。可以是 datetime 之一。

  • lambda (可选, lambda):每个更新间隔要评估的 lambda,用于获取日期时间的当前值。

  • set_action (可选, 动作):当远程端(如 Home Assistant 前端)请求设置日期时间值时应执行的动作。新值在 x 变量中可供 lambda 使用。

  • update_interval (可选, 时间):通过执行 lambda 更新日期时间的间隔。默认为 60s

  • optimistic (可选, boolean):是否以乐观模式运行——在此模式下,发送到模板日期时间的任何命令都会立即更新报告的状态。不能与 lambda 一起使用。默认为 false

  • restore_value (可选, boolean):将状态保存并加载到 RTC/Flash。不能与 lambda 一起使用。默认为 false

  • initial_value (可选, string):如果未通过 restore_value 恢复,则在设置时要将状态设置为的值。可以是以下之一:

    • 对于 type: date

      • 格式为 %Y-%m-%d 的字符串,例如:"2023-12-04"
      • 包含 yearmonthday 的对象。
initial_value:
year: 2023
month: 12
day: 4
  • 对于 type: time

    • 格式为 %H:%M:%S 的字符串,例如:"12:34:56"
    • 包含 hourminutesecond 的对象。
initial_value:
hour: 12
minute: 34
second: 56
  • 对于 type: datetime

    • 格式为 %Y-%m-%d %H:%M:%S 的字符串,例如:"2023-12-04 12:34:56"
    • 包含 yearmonthdayhourminutesecond 的对象。
initial_value:
year: 2023
month: 12
day: 4
hour: 12
minute: 34
second: 56