SYS_LDATE

Datum und Zeit

SYS_TIME_PHYSICAL

---

SYS_TIME

Script-Funktion: Stellt die aktuelle Tageszeit zu Beginn der Script-Prozessierung fest.

Syntax

SYS_TIME([Zeitformat][,Zeitzone])

Anmerkungen

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

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

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. Die Uhrzeit wird direkt in UTC (Universal Time Coordinated) zurückgegeben.

Die aktuelle Tageszeit 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 dieselbe Tageszeit 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 Zeitformat auf der Windows-Plattform verloren. Die Anzeige des Datums basiert nun auf den Ländereinstellungen in der Systemsteuerung von Windows.

Die Zeit kann immer nur gemeinsam mit einem Datum in einer Variablen vom Typ "Zeitstempel" gespeichert werden. Dabei sind ausschließlich folgende Kombinationen von Datums- und Zeitformat erlaubt: "JJMMTT HHMMSS" (Standard), "JJJJ-MM-TT HH:MM:SS" und "JJJJMMTT HHMMSS".

Beispiele

Das erste Beispiel ermittelt die aktuelle Tageszeit und übergibt den Wert an eine Script-Variable. Dabei wird eine Zeitzone berücksichtigt, die für mitteleuropäische Zeit definiert wurde. Das Ergebnis wird im Aktivierungsprotokoll ausgegeben.

:SET &TIME# = SYS_TIME("HH:MM:SS","TZ.MEZ")
:PRINT &TIME#

Im zweiten Beispiel wird ein Teilbegriff verwendet und mit einer Script-Variablen übergeben. Es werden nur die Sekunden der aktuellen Tageszeit festgestellt.

:SET &FORMAT# = "SS"
:SET &TIME# = SYS_TIME(&FORMAT#)

Wird die Funktion ohne die Angabe von Zeitformat und Zeitzone verwendet, ist die Syntax wie im folgenden Beispiel.

:IF SYS_TIME() = "120000" 
!...
:ENDIF

Im dritten Beispiel werden das aktuelle Tagesdatum und die aktuelle Tageszeit ermittelt und in einem Variablen-Objekt vom Typ "Zeitstempel" gespeichert. Für Datums- und Zeitformat gelten die Standardwerte.

:SET &DATE# = SYS_DATE()
:SET &TIME# = SYS_TIME()
:PUT_VAR ENTRY DATE, , "&DATE# &TIME#"

Siehe auch:

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

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