Fonction de script : Détermine le dernier jour de la période pour une date donnée.
Syntaxe
LAST_OF_PERIOD ([Date Format:]Date, Period Format[, Output Format[, Calendar, Calendar Event]])
|
Syntaxe |
Description / format |
|---|---|
|
Date |
|
|
Period Format |
Voir Formats de date, d'heure et de période dans les scripts. |
|
Output Format |
Format prédéfini pour la date déterminée. |
|
Calendar |
Nom de l'objet calendrier devant être pris en compte pour la période de fin. |
|
Calendar Event |
Nom de l'événement de calendrier à prendre en compte pour la fin de la période. |
|
Codes retour |
|---|
|
Date de la fin de la période au format indiqué. |
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. Le format de date est optionnel. Les formats de date par défaut à utiliser sont "AAMMJJ" ou "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 optionnel. Si le format de sortie n'est pas utilisé, la fonction de script renvoie une date au format "AAMMJJ" par défaut. Note : Lorsque le format de sortie n'est pas utilisé, mais que le calendrier et l'événement de calendrier sont spécifiés, vous devez utiliser des virgules.
Si vous utilisez des calendriers et des événements de calendrier, cette 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 exemple : 0000-00-00).
Conseil : Utilisez l'instruction de script :ON_ERROR pour définir l'action à entreprendre en cas d'erreur. Pour plus d'informations, voir Éléments de script pour la gestion des erreurs.
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) est écrit dans le rapport 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 premier jour correct 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#
Voir aussi :