SYS_TIME_PHYSICAL

Verwenden Sie die Script-Funktion SYS_TIME_PHYSICAL, um die aktuelle Uhrzeit zum Zeitpunkt der Verarbeitung abzurufen. Mit der Script-Funktion können Sie ein Datumsformat und eine optionale Zeitzone angeben.

Tipp: Wenn Ihr Script diese Funktion mehrmals aufruft und sich die Zeit zwischen den Aufrufen ändert, unterscheiden sich die abgerufenen Zeiten. Wenn Sie die Zeit im gesamten Script beibehalten müssen, verwenden Sie SYS_TIME.

Syntax

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

Parameter

• SYS_TIME_PHYSICAL
  Gibt die aktuelle Zeit 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 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 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.

Beispiele

Das folgende Script ruft die aktuelle Zeit zweimal ab, mit einem Intervall von 10 Sekunden zwischen den zwei Aufrufen. Die Zeiten werden in Script-Variablen im Format HH:MM:SS gespeichert.

:SET &TIME1# = SYS_TIME_PHYSICAL("HH:MM:SS")
:WAIT 10
:SET &TIME2# = SYS_TIME_PHYSICAL("HH:MM:SS")

Das folgende Script bestimmt die aktuelle Tageszeit in UTC. Nach einer Wartezeit von 10 Sekunden verwendet das Script ein Zeitzonenobjekt, um die aktuelle Zeit in mitteleuropäischer Zeit zu bestimmen. Die abgerufenen Zeiten sollten sich um 1 Stunde und 10 Sekunden unterscheiden.

:SET &TIME1# = SYS_TIME_PHYSICAL("HH:MM:SS","UTC")
:WAIT 10
:SET &TIME2# = SYS_TIME_PHYSICAL("HH:MM:SS","TZ.MEZ")

Das folgende Beispiel gibt ein Zeitformat an, um die Minuten der aktuellen Zeit abzurufen.

:SET &FORMAT# = "MM"
:SET &TIME# = SYS_TIME_PHYSICAL(&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_PHYSICAL() = "120000"  
!...
:ENDIF

Siehe auch: