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：距離下一個半週年紀念日的天數

關於計量單位的說明

測量單位不可翻譯。但是，您可以在配置中變更測量單位的文字。請注意，感測器始終會在幾天內報告，這只是允許您用自己的語言表示這一點。