DTADD : incrémentation d'un composant date ou date-heure

À partir d'une date donnée au format standard date ou date-heure, DTADD retourne une nouvelle date après avoir ajouté le numéro spécifié d'un composant supporté. Le format de date retourné est le même que le format de date d'entrée.

Syntaxe : Incrémenter un composant date ou date-heure

DTADD(date, component, increment)

où :

date

Date ou date-heure

est la valeur date ou date-heure à incrémenter.

component

Mot-clé

est le composant à incrémenter. Les composant valides (et les valeurs acceptables) sont :

YEAR (1-9999)
QUARTER (1-4)
MONTH (1-12)
WEEK (1-53). Ceci est affecté par le paramètre WEEKFIRST.
DAY (du mois, 1-31)
HOUR (0-23)
MINUTE (0-59)
SECOND (0-59)

increment

Entier

est la valeur (positives et négatives) à ajouter au composant.

Haut de page

Exemple : Incrémentation du composant DAY d'une date

La requête suivante sur la source de données WF_RETAIL ajoute trois jours à la date de naissance de l'employé :

DEFINE FILE WF_RETAIL
NEWDATE/YYMD = DTADD(DATE_OF_BIRTH, DAY, 3);
MGR/A3 = DIGITS(ID_MANAGER, 3);
END
TABLE FILE WF_RETAIL
SUM MGR NOPRINT DATE_OF_BIRTH NEWDATE
BY MGR
ON TABLE SET PAGE NOPAGE
END

La sortie est :

Référence : Notes d'utilisation pour DTADD

Chaque élément doit être manipulé séparément. Par conséquent, si vous voulez ajouter 1 an et 1 jour à une date, vous devez invoquer la fonction deux fois, une fois pour YEAR (en prenant en compte les années bissextiles) et une seconde fois pour DAY. Les fonctions simplifiées peuvent être placées dans une expression unique, ou bien crées puis appliquées dans des expressions DEFINE ou COMPUTE.
Pour respecter la validation du paramètre, DTADD ne permettra qu'une valeur standard date ou date-heure qui sera utilisée dans le premier paramètre.
L'incrémentation n'est pas vérifiée, l'utilisateur doit donc savoir que les nombres décimaux ne sont pas pris en charge et seront donc tronqués. Toute combinaison de valeurs qui augmente YEAR au-delà de 9999 retourne la date d'entrée en tant que valeur, sans message associé. Si l'utilisateur reçoit la date d'entrée alors qu'il s'attend à autre chose, il est possible qu'il y ait eu une erreur.