Anniversaries

Anniversaires

Le composant « anniversaires » est un capteur personnalisé de Home Assistant qui compte à rebours jusqu'à une date récurrente telle que les anniversaires, mais peut être utilisé pour tout anniversaire qui survient chaque année à la même date.

Toutes les entrées d'anniversaire configurées seront ajoutées au calendrier de l'assistant domestique. Cela génère également l'entité calendar.anniversaries , qui affiche des informations sur le prochain anniversaire configuré. NB Pour le moment, seules les prochaines occurrences des anniversaires sont ajoutées au calendrier

Table des matières

• Installation
  • Installation manuelle
  • Installation via HACS
• Configuration
  • Paramètres de configuration
• État et attributs
  • État
  • Attributs
  • Remarques sur l'unité de mesure

Installation

INSTALLATION MANUELLE

1. Téléchargez le fichier anniversaries.zip à partir de la dernière version.
2. Décompressez la version et copiez le répertoire custom_components/anniversaries dans le répertoire custom_components de votre installation Home Assistant.
3. Configurez le capteur anniversaries .
4. Redémarrez Home Assistant.

INSTALLATION PAR HACS

1. Assurez-vous que HACS est installé.
2. Recherchez et installez l’intégration « anniversaires ».
3. Configurez le capteur anniversaries .
4. Redémarrez Home Assistant.

Configuration

Les anniversaires peuvent être configurés dans le menu des intégrations ou dans configuration.yaml

Flux de configuration

Dans Configuration/Intégrations cliquez sur le bouton +, sélectionnez Anniversaires et configurez les options du formulaire.

configuration.yaml

Ajoutez un capteur anniversaries dans votre configuration.yaml . L'exemple suivant ajoute deux capteurs : l'anniversaire et l'anniversaire de mariage de Shakespeare !

 # Example configuration.yaml entry

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

PARAMÈTRES DE CONFIGURATION

Paramètre	Facultatif	Description
name	Non	Nom convivial
date	date ou date_template DOIT être incluse	date au format 'YYYY-MM-DD' (ou 'MM-DD' si l'année est inconnue)
date_template	date ou date_template DOIT être incluse	Modèle à partir duquel évaluer la date (Notez que ceci est UNIQUEMENT disponible dans la configuration YAML) Le modèle doit renvoyer une chaîne au format 'YYYY-MM-DD' ou 'MM-DD' , c'est-à-dire : date_template: '{{ states("input_datetime.your_input_datetime") | string }}'
count_up	Oui	true ou false change l'état pour compter à partir d'une date (peut être utile pour des événements non récurrents) Par défaut : false
one_time	Oui	true ou false . Pour un événement ponctuel (Non récurrent) Par défaut : false
show_half_anniversary	Oui	true ou false . Active les attributs half_anniversary_date days_until_half_anniversary . Par défaut : false
unit_of_measurement	Oui	Votre choix d'étiquette NB Le capteur renvoie toujours des Jours, mais cette option vous permet d'exprimer cela dans la langue de votre choix sans avoir besoin d'une personnalisation
id_prefix	Oui	Votre choix de préfixe pour l'entity_id Par défaut : anniversary_ . l'entity_id ne peut pas être modifié depuis l'intégration une fois celle-ci créée. Vous pouvez soit supprimer votre entité et la recréer, soit renommer manuellement l'entity_id sur la page configuration -> entités.
icon_normal	Oui	Icône par défaut Par défaut : mdi:calendar-blank
icon_today	Oui	Icône si l'anniversaire est aujourd'hui Par défaut : mdi:calendar-star
days_as_soon	Oui	Jours à l'avance pour afficher l'icône définie dans icon_soon Par défaut : 1
icon_soon	Oui	Icône si l'anniversaire est 'bientôt' Par défaut : mdi:calendar

État et attributs

État

• Nombre de jours restants avant la prochaine occurrence. (ou jours depuis la dernière occurrence si vous avez choisi l'option de décompte)

Attributs

• années à l'anniversaire : nombre d'années qui se seront écoulées au moment de l'événement (NON affiché si l'année est inconnue)
• années en cours : nombre d'années écoulées depuis la première occurrence (c'est-à-dire l'âge actuel) (NON affiché si l'année est inconnue)
• date : La date de la première occurrence (ou la date de la prochaine occurrence si l'année est inconnue)
• next_date : La date de la prochaine occurrence
• week_remaining : le nombre de semaines jusqu'à l'anniversaire
• unit_of_measurement : 'Days' Par défaut, ceci est affiché après l'état. ce n'est PAS traduisible. Voir ci-dessous pour une solution de contournement
• half_anniversary_date : La date du prochain demi-anniversaire (si activé par show_half_anniversary )
• jours_until_half_anniversary : le nombre de jours jusqu'au prochain demi-anniversaire

Remarques sur l'unité de mesure

Unit_of_measurement n'est pas traduisible. Vous pouvez cependant modifier le texte de l'unité de mesure dans la configuration. NB : le capteur rapportera toujours en jours, cela vous permet simplement de le représenter dans votre propre langue.