Dans une colonne de type formule, la fonction YEAR_ADD() affiche une date obtenue en ajoutant un nombre d'années à une colonne de type date.
-
Nom de la fonction date :
YEAR_ADD()
Syntaxe
YEAR_ADD(colonne_date, nombre_d_annees)
Appel des paramètres de fonction dans TimeTonic :
- $nom_du_champ = champ (lien, colonne de table liée, nombre, sélection, formule, texte...).
- "texte libre" = texte libre à ajouter entre guillemets.
- ne pas utiliser de guillemets pour les nombres.
Paramètres
| Paramètre | Description |
|---|---|
colonne_date |
La colonne de type date à laquelle ajouter des années. |
nombre_d_annees |
Le nombre entier d'années à ajouter. Positif pour avancer la date, négatif pour la reculer. |
Exemple
YEAR_ADD($Date, 1)
La colonne renvoie la date décalée d'un an.
Notes
- Le nombre d'années peut être négatif : la fonction recule alors la date.
Type de retour
La fonction renvoie une date.
Le format du type de sortie du résultat peut être configuré dans les options du champ de sortie de l'éditeur de formule. Pour plus de détails, consultez Options de format de sortie dans l'article Colonne de formule.
Cas d'usage métier
YEAR_ADD() calcule des échéances annuelles : date d'anniversaire de contrat, fin de garantie, date de reconduction.
Bonne pratique
Pour repérer les échéances à venir, combinez YEAR_ADD() avec DAY_DELTA_TODAY() sur la date obtenue.