Utilisez la fonction de script ADD_DAYS pour ajouter des jours à une date donnée. Cette fonction vous permet également de calculer la date selon les événements de calendrier définis dans l'objet Calendrier.
Syntaxe
ADD_DAYS ([Date Format:]Date, Days[, Calendar, Calendar Event])
Paramètres
-
ADD_DAYS
Ajoute un nombre de jours à une date spécifiée -
Date
Spécifie la date au format AAAAMMJJ ou AAAAMMJJ
Remarque : le format de date s'applique à la fois à la date que vous spécifiez et à celle renvoyée par la fonction de script.
Format : littéral de script ou variable de script
(Optionnel) pour utiliser un autre format, saisissez le format de date, suivi d'un séparateur (: ou ;) et de la date. -
Days
Nombre de jours à ajouter à la date
Format : littéral de script, nombre sans guillemets ou variable de script
Conseil : Spécifiez 0 jour pour valider une date par rapport à un objet Calendrier. Si la date est valide pour le calendrier, la fonction de script renvoie la date spécifiée. Si la date n'est pas valide, la fonction de script renvoie la date valide précédente à partir des conditions calendaires. -
Calendar
(Optionnel) Nom d'un objet calendrier
Si vous spécifiez un objet Calendrier, le calcul ne prend en compte que les jours définis dans les événements de calendrier de l'objet Calendrier.
Format: Nom AE, littéral de script ou variable de script -
Calendar Event
(Optionnel) Nom d'un événement de calendrier, si vous spécifiez un objet Calendrier
Format: Nom AE, littéral de script ou variable de script
Codes retour
Cette fonction de script a les codes retour suivants :
- 0
Aucun jour n'a été affecté à l'événement de calendrier ou la date calculée est hors plage du calendrier - 20327
L'objet Calendrier n'existe pas - 20328
L'événement de calendrier n'existe pas dans l'objet Calendrier
Remarque : Le calcul du calendrier tient automatiquement compte de la plage du calendrier spécifié. La plage du calendrier dépend des paramètres client NOW_MINUS et NOW_PLUS. Pour plus d'informations, voir UC_CLIENT_SETTINGS - Divers paramètres du client.
Exemples
L'exemple suivant illustre l'ajout de deux jours à la date spécifiée. La date est au format par défaut AAMMJJ. Le script écrit le résultat (000401) dans le rapport d'activation.
:SET &DATE# = ADD_DAYS("000330", 2)
:PRINT &DATE#
Dans l'exemple suivant, le script affecte la date actuelle à une variable de script et utilise le format de date AAMMJJ par défaut. Le script écrit le résultat (000401) dans le rapport d'activation.
:SET &DATE1# = "000330"
:SET &DATE2# = ADD_DAYS(&DATE1#, 2)
:PRINT &DATE2#
L'exemple suivant illustre l'extraction de la date actuelle à un format qui n'est pas le format de date par défaut pour ADD_DAYS. La fonction ADD_DAYS extrait le prochain jour ouvré valide en utilisant les définitions de l'objet Calendrier appelé COMPANY. Ce format de date spécial est spécifié dans les paramètres de la fonction ADD_DAYS.
:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &NWRKDAY# = ADD_DAYS("DD.MM.YY:&CURDATE#", 1, COMPANY, WORKDAY)
Voir aussi :