FIRST_OF_PERIOD

Verwenden Sie die Script-Funktion FIRST_OF_PERIOD, um den ersten Tag des Zeitraums für ein angegebenes Datum abzurufen. Der Zeitraum kann ein Jahr, ein Quartal, ein Monat oder eine Woche sein. Mit der Script-Funktion können Sie das Datumsformat für das zurückgegebene Datum angeben. Geben Sie optional ein Kalenderereignis an, das für die Berechnung zu berücksichtigen ist.

Syntax

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

Parameter

• FIRST_OF_PERIOD
  Bestimmt den ersten Tag eines Zeitraums für ein angegebenes Datum

• Datum
  Gibt das Datum an
  Format: Script-Literal oder Script-Variable
  Hinweis: Geben Sie das Datumsformat an, wenn Sie ein anderes Format als YYMMDD oder YYYYMMDD verwenden. Trennen Sie das Datumsformat und das Datum durch einen Doppelpunkt oder ein Semikolon. Siehe Datums-, Zeit- und Periodenformate in Scripts.
  

• Periodenformat
  Definiert den Typ des Zeitraums, der für die Berechnung verwendet werden soll
  Format: Script-Literal oder Script-Variable
  Tipp:Unterschiedliche wöchentliche Periodenformate sind verfügbar, je nachdem, ob die Woche am Sonntag oder Montag beginnt. Siehe Datums-, Zeit- und Periodenformate in Scripts.
  

• Ausgabeformat
  (Optional) Datumsformat für den zurückgegebenen Wert
  Format:Script-Literal oder Script-Variable
  Standard: YYMMDD
  

• Kalender, Kalenderereignis
  (Optional) Name des Kalenderereignisses und zu berücksichtigendes Kalenderereignis für die Berechnung des Periodenanfangs
  Weitere Informationen:Kalender (CALE)
  Format:AE-Name, Script-Literal oder Script-Variable
  Hinweis: Wenn Sie kein Kalenderobjekt und kein Kalenderereignis angeben, können Sie die Kommas weglassen.

Wichtig! Geben Sie alle Kommas an, wenn Sie ein Kalenderobjekt und ein Kalenderereignis verwenden, auch wenn Sie den Ausgabeformat-Parameter weglassen.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Datum des Periodenendes im angegebenen Format
• 20327
  Das Kalenderobjekt existiert nicht
• 20328
  Das Kalenderereignis existiert nicht im Kalender-Objekt
• 20456
  Im Kalenderereignis ist das Enddatum der Periode nicht enthalten

Hinweis: Wenn Sie ein Kalenderobjekt und ein Kalenderereignis angeben, gibt die Script-Funktion den korrekten Kalendertag des Zeitraums 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 Maßnahmen zu definieren, die im Fehlerfall ergriffen werden sollen. Weitere Informationen finden Sie unter Script-Elemente zur Fehlerbehandlung.

Beispiele

Diese Beispiele geben das Datum des ersten Tages eines Zeitraums für ein vorgegebenes Datum zurück und geben das Ergebnis im Aktivierungsreport aus.

Der 29. März 2000 war ein Mittwoch. Das folgende Script gibt ein Periodenformat (WW) an, das Montag als ersten Wochentag definiert.

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

Zeile im Aktivierungsreport:

2019-03-28 13:38:28 - U00020408 27.03.00

Das folgende Script verwendet das WS-Periodenformat, um festzulegen, dass die Woche mit Sonntag beginnt. Im Beispiel wird das gleiche Datum wie im vorigen Beispiel verwendet. In diesem Beispiel gibt das Script das Datumsformat an, da das Datum in einem anderen Format als dem Standard angegeben wird.

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

Zeile im Aktivierungsreport:

2019-03-28 13:51:02 - U00020408 26.03.00

Im folgenden Beispiel wird davon ausgegangen, dass Sie ein Kalenderobjekt mit dem Namen READINESS haben, das ein Ereignis (WEEKDAY) enthält, das nur Wochentage, nicht Wochenenden umfasst. Das Script gibt den ersten Wochentag des Quartals zurück, in dem sich das angegebene Datum befindet.

:SET &DATE# = FIRST_OF_PERIOD ("190329", "Q", , READINESS, WEEKDAY)
:PRINT &DATE#

Zeile im Aktivierungsreport:

2019-03-28 13:51:02 - U00020408 01.01.19

Siehe auch: