Utilisez la fonction de script SUB_DAYS pour soustraire un nombre de jour d'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
SUB_DAYS ([Date Format:]Date, Days[, Calendar, Calendar Event])
Paramètres
-
SUB_DAYS
Soustrait un nombre de jours d'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 à soustraire de 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
Dans l'exemple suivant, deux jours sont soustraits de la date spécifiée. La date est au format par défaut AAMMJJ. Le script écrit le résultat (000330) dans le rapport d'activation.
:SET &DATE# = SUB_DAYS("000401", 2)
:PRINT &DATE#
Dans l'exemple suivant, un utilisateur peut définir la durée de stockage de quelque chose. Le script affecte la date actuelle à une variable de script et utilise une instruction :READ pour demander à l'utilisateur le nombre de jours. La fonction SUB_DAYS soustrait de la date actuelle le nombre fourni par l'utilisateur.
:SET &CURRENTDATE# = SYS_DATE()
:READ &NUMBER#,"00","Enter how many days you want to store","08",N
:SET &RETDATE# = SUB_DAYS(&CURRENTDATE#, &NUMBER#)
Dans l'exemple suivant, la date actuelle est extraite et deux jours sont soustraits. Le format de la date actuelle n'est pas le format par défaut. Ce format de date spécial est spécifié dans les paramètres de la fonction SUB_DAYS.
:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &PWRKDAY# = SUB_DAYS("DD.MM.YY:&CURDATE#", 2)
Voir aussi :