SUB_TIMESTAMP

Datum und Zeit

SYS_DATE_PHYSICAL

---

SYS_DATE

Script-Funktion: Ermittelt das aktuelle Tagesdatum zu Beginn der Script-Prozessierung.

Syntax

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

Anmerkungen

Die Script-Funktionen ermittelt das jeweils aktuelle Tagesdatum. Dabei wird eine Zeitzone, welche als Parameter angegeben wurde, berücksichtigt.

Datumsformat ist optional. Es dient dazu das Format festzulegen, in dem die Funktion ihren Wert zurückgeben soll. Haben Sie Datumsformat nicht angegeben, wird das Standardformat "JJMMTT" zurückgegeben.

Zeitzone ist ebenfalls optional. Wird die Script-Funktion ohne diesen Parameter aufgerufen, wird die Zeitzone des Objektes verwendet bzw. die des Mandanten, wenn für das Objekt selbst keine Zeitzone definiert wurde. Wurde eine nicht definierte Zeitzone angegeben, wird automatisch mit dem Standardwert (Zeitzone des Mandanten) gerechnet. Anstatt einer Zeitzone kann auch das Schlüsselwort UTC verwendet werden. Das Datum wird direkt in UTC (Universal Time Coordinated ) zurückgegeben.

Das aktuelle Tagesdatum wird zu Beginn der Script-Prozessierung ermittelt und "eingefroren". Damit wird die Konsistenz des Scripts sichergestellt. Wenn Sie die Script-Funktion innerhalb eines Scripts mehrfach verwenden, wird also immer dasselbe Tagesdatum zurückgegeben. Das gilt insbesondere auch dann, wenn die Scriptbearbeitung durch eine :WAIT-Anweisung für einen festgelegten Zeitraum unterbrochen wird.

Um das ermittelte Tagesdatum mit der Script-Anweisung :PUT_VAR an ein Variablen-Objekt vom Typ "Zeitstempel" zu übergeben, müssen die Datumsformate "JJMMTT" (Standard),  "JJJJMMTT" oder "JJJJ-MM-TT" verwendet werden. Mit dem Speichern in der Variable geht dieses Datumsformat auf der Windows-Plattform verloren. Die Anzeige des Datums basiert nun auf den Ländereinstellungen in der Systemsteuerung von Windows.

Beispiele

Das erste Beispiel ermittelt das Tagesdatum und übergibt den Wert an eine Script-Variable. Im zweiten Beispiel soll gezeigt werden, dass auch die Angabe von Teilbegriffen möglich ist. Es wird der Wochentag festgestellt und als Funktionsparameter eine Script-Variable verwendet.

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

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

Wird die Funktion ohne die Angabe von Datumsformat verwendet, ist die Syntax wie im folgenden Beispiel.

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

Im dritten Beispiel wird das aktuelle Tagesdatum ermittelt und in einem Variablen-Objekt vom Typ "Zeitstempel" gespeichert. Dabei wird eine Zeitzone berücksichtigt, die für mitteleuropäische Zeit definiert wurde.

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

Siehe auch:

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung