Manuel des Scripts Automation Engine > Organisation fonctionnelle > Date et heure > SUB_PERIOD

SUB_PERIOD

Fonction de script : Soustrait une période d'une date donnée.

Syntaxe

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.
Format : Format prédéfini pour la période.

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.
Format : Nom AE, littéral de script ou variable de script
Valeur par défaut: "AAMMJJ"  


Code retour

Date au format indiqué.

Remarques

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.

Exemple

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