|
Date et heure |
Date et heure |
ADD_PERIOD |
|
Fonction de script : Ajoute des jours à une date donnée
ADD_DAYS(Date, Days, [[Calendar], [Calendar Keyword]])
|
Syntaxe |
Description / format |
|---|---|
|
Date |
Saisie d'une date au format "AAMMJJ" ou "AAAAMMJJ". Format : littéral de script ou variable de script Il est aussi possible d’indiquer la date dans un autre format de date. Pour cela, saisissez le format de date souhaité suivi d’un séparateur (: ou ;) puis la date. Le format de la date est facultatif. |
|
Jours |
Nombre de jours qui doivent être calculés. |
|
Calendrier |
Nom de l'objet calendrier concerné. |
|
Règle de calendrier |
Nom de la règle de calendrier à prendre en compte. |
|
Code retour |
|---|
|
Date au format indiqué |
Cette fonction ajoute des jours à une date donnée. Ce calcul peut également dépendre d'un calendrier ou d'une règle de calendrier. Seuls les jours définis dans la règle de calendrier sont pris en compte.
Si on indique un format de date spécifique, la date renvoyée correspond à ce format. Sinon, les formats apr défaut "AAMMJJ" ou "AAAAMMJJ" doivent être utilisés et seront retournés. Utilisez deux points ou un point-virgule comme séparateur entre le format de date et la date.
Il est également possible de définir un nombre de jours égal à zéro. Si la date indiquée est valide dans le calendrier, cette date est renvoyée, sinon c'est la date valide précédente (conditions calendaires) qui est retournée.
Pour le calcul de la date, on tient compte de l'intervalle du calendrier indiqué. Cet intervalle dépend des paramètres configurés par l'administrateur dans la variable UC_CLIENT_SETTINGS et dans les clés NOW_MINUS et NOW_PLUS. La fonction de script renvoie la valeur "0" si la date calculée est en dehors de cette plage définie.
Le premier exemple ajoute deux jours à la date spécifiée. Le résultat ("000401") est écrit dans le protocole d'activation.
:SET &DATE# = ADD_DAYS("000330", 2)
:PRINT &DATE#
Le deuxième exemple transmet la date par une variable de script. Comme aucun format de date n'est indiqué, le format par défaut "AAMMJJ" est utilisé. Le résultat ("000401") est à nouveau écrit dans le protocole d'activation.
:SET &DATE1# = "000330"
:SET &DATE2# = ADD_DAYS(&DATE#, 2)
:PRINT &DATE2#
Le troisième exemple récupère le prochain jour ouvré valide. On utilise ainsi les définitions du calendrier de l'entreprise. Comme la date courante n'est pas récupérée au format par défaut, le format de date spécial doit être à nouveau indiqué pour la variable de script.
:SET &CURDATE# = SYS_DATE("DD.MM.YY")
:SET &NWRKDAY# = ADD_DAYS("DD.MM.YY:&CURDATE#", 1, COMPANY, WORKDAY)
Rubriques connexes :
Eléments de script - Date et heure
Formats de date, d'heure et de période
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle