Dans une colonne de type formule, la fonction DATE_ADDNB() affiche une date obtenue en ajoutant, à une colonne de type date, le nombre de jours contenu dans une colonne de type nombre entier. La date initiale est comptée comme un jour plein.
-
Nom de la fonction date :
DATE_ADDNB()
Syntaxe
DATE_ADDNB(colonne_date, colonne_nombre)
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 servant de point de départ. |
colonne_nombre |
La colonne de type nombre entier indiquant le nombre de jours à ajouter. Positif pour avancer la date, négatif pour la reculer. |
Exemple
Pour calculer une date de rappel à partir d'une date de dernière rencontre et d'un délai stocké dans une colonne :
DATE_ADDNB($Dernière rencontre, $Rappel)
Selon la valeur de la colonne Rappel, TimeTonic ajoute ce nombre de jours à la date de dernière rencontre pour renvoyer la date de rappel.
Notes
- La date initiale est comptée comme un jour plein :
DATE_ADDNB(10/10, 3)renvoi12/10(le 10/10 compte comme le premier jour). - Le résultat est donc décalé d'un jour par rapport à
DATE_ADD(), qui n'inclut pas la date de départ dans le comptage. - Le nombre de jours peut être négatif.
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
DATE_ADDNB() calcule des échéances dont le délai varie d'un enregistrement à l'autre : date de rappel selon une périodicité propre au client, prochaine visite selon un délai contractuel.
Bonne pratique
Choisissez la fonction selon le comptage attendu : DATE_ADD() pour un décalage strict (sans la date de départ), DATE_ADDNB() lorsque la date initiale doit compter comme le premier jour.