SYS_DATE

Verwenden Sie die Script-Funktion SYS_DATE, um das aktuelle Datum abzurufen. Die Script-Funktion gibt das Datum zu Beginn der Script-Verarbeitung zurück und fixiert dieses Datum für die restliche Verarbeitung.

Tipp:Verwenden Sie SYS_DATE_PHYSICAL, um das aktuelle Datum zur Verarbeitungszeit abzurufen.

Syntax

SYS_DATE ([Datumsformat][,Zeitzone|UTC])

Parameter

• SYS_DATE
  Gibt das aktuelle Datum zu Beginn der Verarbeitung zurück

• Datumsformat
  (Optional) Datumsformat für das abgerufene Datum
  Weitere Informationen finden Sie unter Datums-, Zeit- und Periodenformate in Scripts.
  Format: Script-Literal oder Script-Variable
  Standard: YYMMDD

• Zeitzone oder UTC
  (Optional) Gibt die Zeitzone für das Datum an
  Format:Script-Literal oder Script-Variable
  Zulässige Werte:

  • Name eines Zeitzonen-Objekts
    Weitere Informationen finden Sie unter Zeitzone (TZ).
    Format: Script-Literal oder Script-Variable
  • UTC
    Gibt das Datum in UTC (Coordinated Universal Time) zurück

Hinweise:

• Die Zeitzone, die in den Objektattributen definiert ist, gilt, sofern Sie keine andere Zeitzone angeben.
• Wenn das Objekt keine definierte Zeitzone hat, oder wenn Sie ein nicht definiertes Zeitzonenobjekt angeben, gilt die für den Mandanten definierte Zeitzone.
• Das abgerufene Datum bleibt gleich, auch wenn Sie die Script-Funktion innerhalb eines Scripts mehrmals verwenden. Konsistenz ist besonders wichtig, wenn die Script-Verarbeitung mit der Script-Anweisung :WAIT unterbrochen wird.

Wichtig! Wenn Sie eine :PUT_VAR-Script-Anweisung verwenden, um das aktuelle Datum in ein VARA-Objekt mit dem Datentyp Zeitstempel zu übertragen, verwenden Sie eines der folgenden Datumsformate:

• YYMMDD (Standard)
• YYYYMMDD
• YYYY-MM-DD

Hinweis: (Nur Windows) Das Datumsformat wird nach dem Speichern im VARA-Objekt nicht gespeichert. Das angezeigte Datumsformat wird durch die regionalen Optionen bestimmt, die in der Systemsteuerung von Windows festgelegt sind.

Beispiele

Im folgenden Beispiel ruft das Script das aktuelle Datum ab und gibt ein Datumsformat an. Das abgerufene Datum wird in einer Script-Variablen gespeichert.

: SET   &DATE# = SYS_DATE ( "DD.MM.YYYY" )

Das folgende Beispiel gibt ein Kalenderwochen-Datumsformat an, um den aktuellen Wochentag abzurufen.

: SET   &FORMAT# = "WW"
: SET   &WEEKDAY# = SYS_DATE ( &FORMAT# )

Im folgenden Beispiel wird kein Datumsformat angegeben. Das Script verwendet das aktuelle Datum im standardmäßigen YYMMDD-Format, um eine Bedingung zu definieren.

: IF   SYS_DATE () = "990101"
!...
: ENDIF

Das folgende Beispiel ruft das aktuelle Datum ab und speichert den Wert in einem VARA-Objekt mit dem Datentyp Zeitstempel. Das Script verwendet ein Zeitzonenobjekt, das für die mitteleuropäische Zeit (CET) konfiguriert ist.

: SET   &DATE# = SYS_DATE ( "YYYY-MM-DD" , "TZ.CET" )
: PUT_VAR BOOKING.DATE, , &DATE#

Siehe auch: