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

LAST_OF_PERIOD

Fonction de script : Détermine le dernier jour de la période pour une date donnée.

Syntaxe

LAST_OF_PERIOD(Date, Period Format, [Output Format], [[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.

Format de période

Indication d'un format de 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  

Calendrier

Nom du calendrier devant être pris en compte pour la période de fin.
Format : Nom AE, littéral de script ou variable de script

Règle de calendrier

Nom de la règle de calendrier devant être prise en compte pour la fin de période.
Format : Nom AE, littéral de script ou variable de script 


Codes retour

Date de la fin de la période au format indiqué.
"20327" : l'objet calendrier n'existe pas.
"20328" : la règle de calendrier n'existe pas dans l'objet calendrier.
"20456" : la date de la fin de la période ne figure pas dans la règle de calendrier.

Remarques

La fonction de script détermine le dernier jour de la période à laquelle la date indiquée appartient. Le code retour est une date.

La fonction de script reçoit une date. L'indication d'un format de date est facultative. Les formats de date par défaut à utiliser sont "AAMMJJ" et "AAAAMMJJ". Deux points ou un point-virgule sont autorisés comme séparateur entre le format de date et la date.

Le type de période (année, trimestre, mois ou semaine) est défini par le format de période.
Remarque :
Le format de période spécial "WS" s'applique à cette fonction. Ce format indique que le dimanche est le premier jour de la semaine. "WW" au contraire indique que le lundi est le premier jour de la semaine.

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. Notez : Si vous spécifiez des calendriers et des règles de calendriers, utilisez des virgules si aucun format de sortie n'est utilisé.

Si vous utilisez des calendriers et des règles de calendriers, la fonction de script renvoie le jour calendaire correct de la période. Si aucun jour n'est valide pour cette période, le résultat est une date nulle au format de date courant (par ex. 0000-00-00).

L'instruction de script :ON_ERROR permet de définir la réaction à cette erreur. Vous pouvez analyser l'erreur avec les fonctions de script pour le traitement des erreurs. Le traitement du script se poursuit. Toutefois, vous avez également la possibilité de l'interrompre.

Exemples

Le premier exemple détermine le dernier jour de la semaine pour le 29.03.2000. Le résultat 02/04/2000 (dimanche) est affiché dans le rapport d'activation.

:SET &DATE#=LAST_OF_PERIOD ("000329","WW","DD.MM.YY")
:
PRINT &DATE#

Lorsque le format de période spécial "WS" est utilisé, le 01.04.00 (samedi) apparaît comme résultat dans le protocole d'activation.

:SET &DATE#=LAST_OF_PERIOD ("DD.MM.YY:29.03.00","WS","DD.MM.YY")
:
PRINT &DATE#

Dans le troisième exemple, le dernier jour pertinent d'un trimestre est déterminé. Le format de sortie n'est pas pris en compte.

:SET &DATE#=LAST_OF_PERIOD ("000329", "Q", , READINESS, WEEKDAY)
:
PRINT &DATE#

 

Rubriques connexes :

Elément de script Description

FIRST_OF_PERIOD

Détermine le premier jour de la période pour une date donnée.

:ON_ERROR

Détermine la réaction à certaines erreurs ou messages d'éléments de script. 

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