Anniversaries

周年纪念日

“周年纪念日”组件是一个家庭助理定制传感器，它可以倒计时到生日等重复日期，但也可用于每年同一日期发生的任何周年纪念日。

配置的任何周年纪念条目都将添加到家庭助理日历中。这还会生成calendar.anniversaries实体，该实体显示有关下一个配置的周年纪念日的信息。注意：目前，仅将下一次出现的周年纪念日添加到日历中

目录

• 安装
  • 手动安装
  • 通过 HACS 安装
• 配置
  • 配置参数
• 状态和属性
  • 状态
  • 属性
  • 关于计量单位的说明

安装

手动安装

1. 下载最新版本的anniversaries.zip文件。
2. 解压该版本并将custom_components/anniversaries目录复制到 Home Assistant 安装的custom_components目录中。
3. 配置anniversaries传感器。
4. 重新启动家庭助理。

通过 HACS 安装

1. 确保已安装 HACS。
2. 搜索并安装“周年纪念”集成。
3. 配置anniversaries传感器。
4. 重新启动家庭助理。

配置

可以在集成菜单或configuration.yaml中配置周年纪念日

配置流程

在“配置/集成”中，单击“+”按钮，选择“周年纪念日”并配置表单上的选项。

配置.yaml

在您的configuration.yaml中添加anniversaries传感器。下面的例子添加了两个传感器——莎士比亚的生日和结婚纪念日！

 # Example configuration.yaml entry

anniversaries :
  sensors :
  - name : Shakespeare's Birthday
    date : ' 1564-04-23 '
  - name : Shakespeare's Wedding Anniversary
    date : ' 1582-11-27 '

配置参数

范围	选修的	描述
name	不	友好的名字
date	必须包含date或date_template	日期格式为'YYYY-MM-DD' （如果年份未知，则为'MM-DD' ）
date_template	必须包含date或date_template	用于评估日期的模板（请注意，这仅在 YAML 配置中可用）该模板必须返回'YYYY-MM-DD'或'MM-DD'格式的字符串，即： date_template: '{{ states("input_datetime.your_input_datetime") | string }}'
count_up	是的	true或false更改状态以从日期开始计数（对于非重复事件非常有用）默认值： false
one_time	是的	是true false 。对于一次性事件（非重复）默认值： false
show_half_anniversary	是的	是true false 。启用half_anniversary_date和days_until_half_anniversary属性。默认值： false
unit_of_measurement	是的	您选择的标签 注意：传感器始终返回天数，但此选项允许您用您选择的语言表达这一点，而无需自定义
id_prefix	是的	您选择的entity_id 前缀默认值： anniversary_注意。一旦创建，entity_id 就无法在集成内更改。您可以删除实体并重新创建它，或者在配置 -> 实体页面上手动重命名实体_id
icon_normal	是的	默认图标默认： mdi:calendar-blank
icon_today	是的	如果周年纪念日是今天，则图标默认： mdi:calendar-star
days_as_soon	是的	显示icon_soon中定义的图标的提前天数默认值：1
icon_soon	是的	如果周年纪念日为“即将”，则图标默认： mdi:calendar

状态和属性

状态

• 距离下一次事件发生的剩余天数。 （如果您选择了向上计数选项，则为自上次发生以来的天数）

属性

• 周年纪念日的年数：倒计时到的事件发生时已过去的年数（如果年份未知则不显示）
• 当前年份：自第一次出现以来已经过去的年数（即当前年龄） （如果年份未知则不显示）
• 日期：第一次出现的日期（如果年份未知，则为下次出现的日期）
• next_date：下一次发生的日期
• week_remaining：距周年纪念日还有多少周
• unit_of_measurement: 'Days' 默认情况下，它显示在状态之后。这是不可翻译的。请参阅下面的解决方法
• half_anniversary_date：下一个半周年纪念日的日期（如果通过show_half_anniversary启用）
• days_until_half_anniversary：距下一个半周年纪念日的天数

关于计量单位的说明

测量单位不可翻译。但是，您可以在配置中更改测量单位的文本。请注意，传感器始终会在几天内报告，这只是允许您用自己的语言表示这一点。