Anniversaries

Aniversários

O componente 'aniversários' é um sensor personalizado do Home Assistant que faz a contagem regressiva até uma data recorrente, como aniversários, mas pode ser usado para qualquer aniversário que ocorra anualmente na mesma data.

Quaisquer entradas de aniversários configuradas serão adicionadas ao calendário do assistente doméstico. Isso também gera a entidade calendar.anniversaries , que mostra informações sobre o próximo aniversário configurado. NB No momento, apenas as próximas ocorrências dos aniversários são adicionadas ao calendário

Índice

• Instalação
  • Instalação manual
  • Instalação via HACS
• Configuração
  • Parâmetros de configuração
• Estado e Atributos
  • Estado
  • Atributos
  • Notas sobre unidade de medida

Instalação

INSTALAÇÃO MANUAL

1. Baixe o arquivo anniversaries.zip da versão mais recente.
2. Descompacte a versão e copie o diretório custom_components/anniversaries para o diretório custom_components da instalação do Home Assistant.
3. Configure o sensor anniversaries .
4. Reinicie o Assistente Doméstico.

INSTALAÇÃO VIA HACS

1. Certifique-se de que o HACS esteja instalado.
2. Procure e instale a integração "aniversários".
3. Configure o sensor anniversaries .
4. Reinicie o Assistente Doméstico.

Configuração

Os aniversários podem ser configurados no menu de integrações ou em configuration.yaml

Fluxo de configuração

Em Configuração/Integrações clique no botão +, selecione Aniversários e configure as opções do formulário.

configuração.yaml

Adicione o sensor anniversaries em seu configuration.yaml . O exemplo a seguir adiciona dois sensores – aniversário de Shakespeare e aniversário de casamento!

 # Example configuration.yaml entry

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

PARÂMETROS DE CONFIGURAÇÃO

Parâmetro	Opcional	Descrição
name	Não	Nome amigável
date	date ou date_template DEVEM ser incluídos	data no formato 'YYYY-MM-DD' (ou 'MM-DD' se o ano for desconhecido)
date_template	date ou date_template DEVEM ser incluídos	Modelo para avaliar a data (Observe que isso está disponível SOMENTE na configuração YAML) O modelo deve retornar uma string no formato 'YYYY-MM-DD' ou 'MM-DD' , ou seja: date_template: '{{ states("input_datetime.your_input_datetime") | string }}'
count_up	Sim	true ou false altera o estado para contagem crescente a partir de uma data (pode ser útil para eventos não recorrentes) Padrão : false
one_time	Sim	true ou false . Para um evento único (não recorrente) Padrão : false
show_half_anniversary	Sim	true ou false . Ativa os atributos half_anniversary_date e days_until_half_anniversary . Padrão : false
unit_of_measurement	Sim	Etiqueta à sua escolha NB O sensor sempre retorna Dias, mas esta opção permite que você expresse isso no idioma de sua escolha sem precisar de personalização
id_prefix	Sim	Sua escolha de prefixo para entidade_id Padrão : anniversary_ . o entidade_id não pode ser alterado na integração depois de criada. Você deve excluir sua entidade e recriá-la ou renomear manualmente o entidade_id na página configuração -> entidades
icon_normal	Sim	Ícone padrão Padrão : mdi:calendar-blank
icon_today	Sim	Ícone se o aniversário for hoje Padrão : mdi:calendar-star
days_as_soon	Sim	Dias de antecedência para exibir o ícone definido em icon_soon Padrão : 1
icon_soon	Sim	Ícone se o aniversário for 'em breve' Padrão : mdi:calendar

Estado e Atributos

Estado

• O número de dias restantes até a próxima ocorrência. (ou dias desde a última ocorrência se você escolheu a opção de contagem progressiva)

Atributos

• anos no aniversário: número de anos que se passaram na ocorrência contados regressivamente (NÃO exibido se o ano for desconhecido)
• anos atuais: número de anos se passaram desde a primeira ocorrência (ou seja, idade atual) (NÃO exibido se o ano for desconhecido)
• data: A data da primeira ocorrência (ou a data da próxima ocorrência se o ano for desconhecido)
• next_date: A data da próxima ocorrência
• semanas_remaining: o número de semanas até o aniversário
• unit_of_measurement: 'Days' Por padrão, isso é exibido após o estado. isso NÃO é traduzível. Veja abaixo a solução alternativa
• half_anniversary_date: A data do próximo meio aniversário (se habilitado por show_half_anniversary )
• dias_until_half_anniversary: ​​o número de dias até o próximo meio aniversário

Notas sobre unidade de medida

Unit_of_measurement não é traduzível. Você pode, no entanto, alterar o texto da unidade de medida na configuração. NB: o sensor sempre reportará em dias, isso apenas permite que você represente isso em seu próprio idioma.