LAST_OF_PERIOD

Script-Funktion: Ermittelt den letzten Tag der Zeitraums eines bestimmten Datums.

Syntax

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

Syntax	Beschreibung/Format
Datum
Periodenformat	Siehe Datums-, Zeit- und Periodenformate in Scripts.
Ausgabeformat	Formatvorgaben für das ermittelte Datum. Format:AE-Name, Script-Literal oder Script-Variable Standard: YYMMDD
Kalender	Name des Kalenderobjektes, das für das Periodenende berücksichtigt werden soll. Format: AE-Name, Script-Literal oder Script-Variable
Kalenderereignis	Name des Kalenderereignisses, das für das Periodenende berücksichtigt werden soll. Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewerte
Datum des Periodenendes im angegebenen Format "20327" - Das Kalenderobjekt existiert nicht "20328" - Das Kalenderereignis ist im Kalenderobjekt nicht vorhanden "20456" - Das Kalenderereignis schließt nicht das Enddatum der Periode ein.

Die Script-Funktion ermittelt den letzten Tag der Periode, zu der ein angegebenes Datum gehört. Der Rückgabewert ist ein Datum.

Der Script-Funktion wird ein Datum zugeordnet. Die Angabe eines Datumsformats ist dabei optional. Wird kein Datumsformat verwendet, muss das Datum in den Formaten "YYMMDD" oder "YYYYMMDD" angegeben werden. Als Trennzeichen zwischen Datumsformat und Datum sind Doppelpunkt oder Semikolon erlaubt.

Mit Periodenformat wird die Art der Periode (Jahr, Quartal, Monat oder Woche) festgelegt.
Hinweis: Für diese Funktion gibt es ein spezielles Periodenformat "WS". Damit wird als erster Tag einer Woche immer der Sonntag genommen. "WW" hingegen geht stets vom Sonntag als letzten Tag der Woche aus.

Ausgabeformat ist optional. Wird Ausgabeformat nicht verwendet, liefert die Script-Funktion ein Datum mit dem Standardformat "YYMMDD" zurück. Hinweise: Kommata sind auch zu setzen, wenn nicht Ausgabeformat verwendet wird, aber Kalender und Kalenderereignis angegeben werden.

Werden Kalender und Kalenderereignis verwendet, gibt die Script-Funktion den letzten zutreffenden Kalendertag der Periode zurück. Wenn es für diesen Zeitraum keinen gültigen Kalendertag gibt, ist das Ergebnis ein Nulldatum im jeweiligen Datumsformat (z.B: 0000-00-00).

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

Beispiele

Das erste Beispiel ermittelt den letzten Tag der Woche für den 29.3.2000. Als Ergebnis wird der 02.04.00 (Sonntag) im Aktivierungsreport ausgegeben.

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

Mit dem speziellen Periodenformat "WS" steht der 01.04.00 (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: