Script-Funktion: Gibt die aktuelle Tageszeit zu Beginn der Script-Verarbeitung zurück.
Syntax
SYS_TIME ([Time Format][,TimeZone])
|
Syntax |
Beschreibung/Format |
|---|---|
|
Time Format |
Format für das angegebene Datum |
|
TimeZone |
Name eines Zeitzonen-Objektes oder UTC-Keyword. |
|
Rückgabewert |
|---|
|
Zeit im angegebenen Format |
Die Script-Funktionen ermittelt das jeweils aktuelle Tagesdatum. Dabei wird eine Zeitzone, welche als Parameter angegeben wurde, berücksichtigt.
Time Format ist optional. Es wird verwendet, um das Format festzulegen, in dem die Funktion Werte zurückgeben soll. Haben Sie kein Time Format angegeben, wird das Standardformat „HHMMSS“ verwendet.
TimeZone 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 UTC-Keyword verwendet werden. Die Uhrzeit wird direkt in UTC (Universal Time Coordinated) zurückgegeben.
Die aktuelle Tageszeit wird zu Beginn der Script-Verarbeitung ermittelt. 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 ein :WAIT-Statement für einen festgelegten Zeitraum unterbrochen wird.
Um das ermittelte Datum mit dem Script-Statement :PUT_VAR an ein Variablenobjekt 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“ 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 Aktivierungsreport 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 ermittelt.
: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: