SYS_TIME

Verwenden Sie die Script-Funktion SYS_TIME, um die aktuelle Zeit abzurufen. Die Script-Funktion gibt die Zeit zu Beginn der Script-Verarbeitung zurück und fixiert diese Zeit für die restliche Verarbeitung.

Tipp: Verwenden Sie SYS_TIME_PHYSICAL, um die aktuelle Zeit zur Verarbeitungszeit abzurufen.

Syntax

SYS_TIME ([Zeitformat][,Zeitzone|UTC])

Parameter

• SYS_TIME
  Gibt die aktuelle Zeit zu Beginn der Verarbeitung zurück

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

• Zeitzone oder UTC
  (Optional) Gibt die Zeitzone für die Zeit 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 die Zeit 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.
• Die abgerufene Zeit 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 die aktuelle Zeit in ein VARA-Objekt mit dem Datentyp Zeitstempel zu übertragen, kann die Uhrzeit nur zusammen mit einem Datum gespeichert werden. Verwenden Sie eine der folgenden Kombinationen von Datums- und Zeitformaten:

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

Hinweis: (Nur Windows) Das Format wird nicht gespeichert, wenn die Variable auf der Windows-Plattform gespeichert wird. Das angezeigte Datumsformat wird durch die regionalen Optionen bestimmt, die in der Systemsteuerung von Windows festgelegt sind.

Beispiele

Das folgende Beispiel ermittelt die aktuelle Tageszeit und übergibt den Wert an eine Script-Variable. Das Script verwendet ein Zeitzonenobjekt, das für die mitteleuropäische Zeit (CET) definiert ist. Das Script gibt die abgerufene Zeit im Aktivierungsreport der Aufgabe aus.

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

Das folgende Beispiel gibt ein Zeitformat an, das die Sekunden der aktuellen Zeit abruft.

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

Im folgenden Beispiel wird kein Zeitformat angegeben. Das Script verwendet die aktuelle Uhrzeit im standardmäßigen HHMMSS-Format, um eine Bedingung zu definieren.

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

Im folgenden Beispiel werden das aktuelle Datum und die aktuelle Uhrzeit abgerufen, und die Werte werden verwendet, um einen Eintrag in einem VARA-Objekt mit dem Datentyp Zeitstempel zu speichern. Das Script verwendet das Standardformat für Datum und Uhrzeit.

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

Siehe auch: