Anniversaries

Юбилеи

Компонент «Годовщины» представляет собой настраиваемый датчик Home Assistant, который ведет обратный отсчет до повторяющейся даты, например дня рождения, но может использоваться для любой годовщины, которая наступает ежегодно в одну и ту же дату.

Любые настроенные записи годовщин будут добавлены в календарь домашнего помощника. При этом также создается сущность calendar.anniversaries , которая отображает информацию о следующей настроенной годовщине. NB. На данный момент в календарь добавляются только ближайшие юбилеи.

Оглавление

• Установка
  • Ручная установка
  • Установка через HACS
• Конфигурация
  • Параметры конфигурации
• Состояние и атрибуты
  • Состояние
  • Атрибуты
  • Примечания о единицах измерения

Установка

РУЧНАЯ УСТАНОВКА

1. Загрузите файл anniversaries.zip из последней версии.
2. Распакуйте выпуск и скопируйте каталог custom_components/anniversaries в каталог custom_components вашей установки Home Assistant.
3. Настройте датчик anniversaries .
4. Перезапустите Домашний помощник.

УСТАНОВКА ЧЕРЕЗ HACS

1. Убедитесь, что система HACS установлена.
2. Найдите и установите интеграцию «юбилеи».
3. Настройте датчик anniversaries .
4. Перезапустите Домашний помощник.

Конфигурация

Годовщины можно настроить в меню интеграции или в файле Configuration.yaml.

Процесс настройки

В разделе «Конфигурация/Интеграция» нажмите кнопку «+», выберите «Годовщины» и настройте параметры в форме.

конфигурация.yaml

Добавьте датчик anniversaries в файл configuration.yaml . В следующем примере добавляются два датчика — день рождения Шекспира и годовщина свадьбы!

 # 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_ NB. entity_id не может быть изменен внутри интеграции после ее создания. Вы можете либо удалить свою сущность и создать ее заново, либо вручную переименоватьentity_id на странице конфигурации -> сущности.
icon_normal	Да	Значок по умолчанию. По умолчанию : mdi:calendar-blank
icon_today	Да	Значок, если годовщина сегодня. По умолчанию : mdi:calendar-star
days_as_soon	Да	За несколько дней до отображения значка, определенного в icon_soon По умолчанию : 1.
icon_soon	Да	Значок, если годовщина наступает «скоро». По умолчанию : mdi:calendar

Состояние и атрибуты

Состояние

• Количество дней, оставшихся до следующего события. (или дней с момента последнего события, если вы выбрали опцию подсчета)

Атрибуты

• лет в годовщину: количество лет, прошедших в момент события, отсчитывается до (НЕ отображается, если год неизвестен)
• текущие годы: количество лет, прошедших с момента первого появления (т. е. текущий возраст) (НЕ отображается, если год неизвестен)
• date: дата первого события (или дата следующего события, если год неизвестен).
• next_date: дата следующего события.
• Weeks_remaining: количество недель до годовщины.
• unit_of_measurement: «Дни» По умолчанию отображается после состояния. это НЕ переводимо. См. ниже обходной путь.
• half_anniversary_date: дата следующего полугодия (если включено show_half_anniversary )
• days_until_half_anniversary: ​​количество дней до следующего полугодия.

Примечания о единицах измерения

Unit_of_measurement не подлежит переводу. Однако вы можете изменить текст единицы измерения в конфигурации. Обратите внимание, что датчик всегда сообщает данные в днях, это просто позволяет вам представить это на вашем родном языке.