LAST_OF_PERIOD

Verwenden Sie die Script-Funktion LAST_OF_PERIOD, um den letzten Tag des Zeitraums zu bestimmten, wozu ein bestimmtes Datum gehört. Der Rückgabewert ist ein Datum. Ein Datum wird der Script-Funktion zugeordnet.

Tipp: Verwenden Sie die Script-Anweisung :ON_ERROR, um Aktionen im Fehlerfall zu definieren. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Syntax

LAST_OF_PERIOD ([Datumsformat:]Datum,, Periodenformat[, Ausgabeformat[, Kalender, Kalenderereignis]])

Parameter

• LAST_OF_PERIOD
  Bestimmt den letzten Tag des Zeitraums eines angegebenen Datums
• Datum
• Period Format
  Definiert den Zeitraumtyp (z. B. Jahr, Quartal, Monat oder Woche)
  Hinweis: Für diese Funktion steht das spezielle Zeitraumformat „WS“ zur Verfügung. Bei diesem Format wird Sonntag als der erste Wochentag definiert. Beim Format „WW“ wird Montag als der erste Wochentag definiert. Weitere Informationen finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.
• Ausgabeformat
  (Optional) Formatvorgabe für das ermittelte Datum. Falls dieser Parameter nicht verwendet wird, gibt die Script-Funktion das Standardformat YYMMDD als Datum zurück.
  Hinweis: Falls dieser Parameter nicht verwendet wird, aber die Schlüssel Calendar und Calendar Event definiert sind, müssen Sie Kommas verwenden.
  Format: AE Name, Script-Literal oder Script-Variable
  Standard: YYMMDD
• Calendar
  (Optional) Name des für den Endzeitraum zu berücksichtigenden Kalenderobjekts
  Format: AE Name, Script-Literal oder Script-Variable
  Hinweis: Falls Calendar und Calendar Event verwendet werden, gibt diese Script-Funktion den richtigen Kalendertag des Zeitraums zurück. Falls es für diesen Zeitraum keinen gültigen Kalendertag gibt, ist das Ergebnis ein Nulldatum im jeweiligen Datumsformat, beispielsweise „0000-00-00“.
• Calendar Event
  (Optional) Name des für den Endzeitraum zu berücksichtigenden Kalenderelements
  Format: AE Name, Script-Literal oder Script-Variable
  Hinweis: Falls Calendar und Calendar Event verwendet werden, gibt diese Script-Funktion den richtigen Kalendertag des Zeitraums zurück. Falls es für diesen Zeitraum keinen gültigen Kalendertag gibt, ist das Ergebnis ein Nulldatum im jeweiligen Datumsformat, beispielsweise „0000-00-00“.

Rückgabewerte

Das Datum des Zeitraumendes im angegebenen Format wird zurückgegeben:

• 20327
  Das Kalenderobjekt ist nicht vorhanden
• 20328
  Das Kalenderereignis ist im Kalenderobjekt nicht vorhanden
• 20456
  Im Kalenderereignis ist das Enddatum des Zeitraums nicht enthalten

Beispiele

Im ersten Beispiel wird der letzte Wochentag für den 29.3.2022 ermittelt. Als Ergebnis wird der 03.04.22 (Sonntag) im Aktivierungsreport ausgegeben.

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

Mit dem speziellen Periodenformat "WS" steht der 02.04.22 (Samstag) als Ergebnis im Aktivierungsreport.

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

Im dritten Beispiel wird der letzte zutreffende Kalendertag eines Quartals ermittelt. Auf die Vorgabe eines Ausgabeformates wird dabei verzichtet.

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

Siehe auch: