Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datum und Zeit > SYS_DATE_PHYSICAL

SYS_DATE_PHYSICAL

Script-Funktion: Ermittelt das jeweils aktuelle Tagesdatum.

Syntax

SYS_DATE_PHYSICAL([Datumsformat], [Zeitzone])

Syntax	Beschreibung/Format
Datumsformat	Formatvorgabe für das ermittelte Datum. Format: Script-Literal oder Script-Variable Standardwert: "JJMMTT"
Zeitzone	Name eines Zeitzonen-Objektes oder das Schlüsselwort UTC. Format: Script-Literal oder Script-Variable

Rückgabewert
Aktuelles Tagesdatum im angegebenen Format.

Anmerkungen

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

Wird die Script-Funktion mehrmals in einem Script verwendet, kann das unter Umständen zu unterschiedlichen Ergebnissen führen (zum Beispiel Datumswechsel zwischen erstem und zweiten Aufruf). Damit unterscheidet sich die Script-Funktion vonSYS_DATE, welche das aktuelle Tagesdatum zu Beginn der Script-Prozessierung ermittelt und dann "einfriert", um die Konsistenz des Scripts zu gewährleisten.

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.

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_PHYSICAL('DD.MM.YYYY')

:SET &FORMAT# = 'WW'
:SET &WEEKDAY# = SYS_DATE_PHYSICAL(&FORMAT#)

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

:IF SYS_DATE_PHYSICAL() = '990101'
!...
:ENDIF

Im dritten Beispiel wird das aktuelle Tagesdatum ermittelt. Dabei wird eine Zeitzone berücksichtigt, die für mitteleuropäische Zeit definiert wurde. Das Ergebnis wird im Aktivierungsprotokoll ausgegeben.

:SET &DATE# = SYS_DATE_PHYSICAL('YYYY-MM-DD','TZ.MEZ')
:PRINT &DATE#

Siehe auch:

Script-Sprachmittel	Beschreibung
CONV_DATE	Konvertiert das Format eines Datums.
DIFF_DATE	Ermittelt die Differenz zwischen zwei Datumsangaben in Tagen.
SYS_LDATE	Ermittelt das logische Datum.
SYS_DATE	Ermittelt das aktuelle Tagesdatum zu Beginn der Script-Prozessierung.

Script-Sprachmittel - Datum und Zeit

Datums-, Zeit- und Periodenformate

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

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support