|
ADD_DAYS |
Date et heure |
ADD_TIME |
|
Fonction de script : Ajoute une période à une date indiquée
ADD_PERIOD(Date, Period Format:Period, [Output Format])
|
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. |
|
Format:Période |
Format : littéral de script ou variable de script Période : Saisissez une période à ajouter à la date donnée. Deux points (:) ou un point-virgule (;) sont autorisés comme séparateur entre le format de la période et la période. |
|
Format de sortie |
Format prédéfini pour la date déterminée. |
|
Code retour |
|---|
|
Date au format indiqué. |
La fonction de script ajoute une année, un mois, un trimestre ou une semaine à la date indiquée.
La fonction de script reçoit une date. L'indication du format de date est optionnelle. Si aucun format de date n'a été spécifié, la date doit être indiquée au format "AAMMJJ" ou "AAAAMMJJ". Deux points ou un point-virgule sont autorisés comme séparateur entre le format de date et la date.
La période est ajoutée à la date indiquée. La période est un nombre. Si le résultat est une date postérieure au 31.12.9999, cela génère une erreur.
Le format de sortie est optionnel. Si aucun format de sortie n'est utilisé, la fonction de script renvoie une date au format "AAMMJJ" par défaut.
Le premier exemple ajoute 2 semaines au 06/02/2000. Le résultat (20.03.2000) est écrit dans le rapport.
:SET &DATE#=ADD_PERIOD ("DD.MM.YY:06.03.00","WW;2","DD.MM.YYYY")
:PRINT &DATE#
Le deuxième exemple ajoute un trimestre au 31.01.2000. Le résultat (30.04.2000) est écrit dans le rapport.
:SET &DATE#=ADD_PERIOD ("000131","Q:1","DD-MM-YYYY")
:PRINT &DATE#
Dans le troisième exemple, une année est ajoutée au 29.02.2000. 28.02.2001 s'affiche dans le rapport, car l'année 2001 n'est pas une année bissextile.
:SET &DATE#=ADD_PERIOD ("20000229","YY:0001",DD.MM.YYYY)
:PRINT &DATE#
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
Script - Liste alphabétique
Eléments de script - Répartition fonctionnelle