Fonction de script : Soustrait une période d'une date donnée.
SUB_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 de période:Période |
Format : littéral de script ou variable de script Période : Spécification d'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 de la date déterminée. |
Code retour |
---|
Date au format indiqué. |
La fonction de script soustrait une année, un mois, un trimestre ou une semaine de la date indiquée.
La fonction de script reçoit une date. L'indication d'un format de date est facultative. Si aucun format de date spécifique n'est utilisé, 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 soustraite de la date indiquée. La période est un nombre. Une erreur est générée si le résultat est une date antérieure à l'année 0000.
Le format de sortie est facultatif. Si le format de sortie n'est pas utilisé, la fonction de script renvoie une date au format "AAMMJJ" par défaut.
N'oubliez pas ceci lors de la soustraction des années, trimestres et mois.
Le premier exemple soustrait deux semaines au 05/07/2000. Le résultat (21/06/2000) est écrit dans le rapport.
:SET &DATE#=SUB_PERIOD ("DD.MM.YY:05.07.00","WW;2","DD.MM.YYYY")
:PRINT &DATE#
Le deuxième exemple soustrait un trimestre au 31/07/2000. Le résultat (30.04.2000) est écrit dans le rapport.
:SET &DATE#=SUB_PERIOD ("000731","Q:1","DD-MM-YYYY")
:PRINT &DATE#
Dans le troisième exemple, une année est soustraite du 28.02.2001. Le résultat 28.02.2000 est affiché dans le rapport.
:SET &DATE#=SUB_PERIOD ("20010228","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
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle